Curator API: Get Sources
GET https://api.curator.io/v1.2/sources returns the sources in your Curator account as JSON. Sources are what pull posts into your feeds, such as an Instagram account or a hashtag. The request needs your API key, and your plan must include API access. Only HTTPS is supported.
Authentication
Send your Curator API key (find it in the Curator Dashboard) in one of three ways: as a query string (?api_key=API_KEY), as a Basic auth header with the API key as the username, or as a Bearer token (Authorization: Bearer API_KEY). The key decides which account you are working in; you only see that account's sources.
Example request
curl "https://api.curator.io/v1.2/sources?api_key=API_KEY&feed_id=FEED_ID"Parameters
Parameter | Description |
|---|---|
| Only sources in this feed, by the feed's API ID. The public key is not accepted here. If no feed in your account has that API ID, the filter is ignored and every source is returned. |
Response
A 200 response is a JSON array of source objects, with no wrapper, no paging, and no set order. Paused and failed sources are included.
Source object
Field | Description |
|---|---|
| The source's API ID (a UUID). Use it as |
| API ID of the feed the source belongs to. |
| The source type as an object, with |
| ID of the source's network. |
| API ID of the connection the source uses, or |
|
|
| The handle, hashtag, search term, or URL the source pulls from. |
| Display name of the source. |
| How often the source checks for new posts, in minutes. |
| Date of the oldest post the source has loaded, in UTC. |
| Number of posts the source has added, and how many times it has failed to update. |
| Author image used on this source's posts, or empty. |
| Author name, handle, and link that replace the original values on this source's posts, as JSON text, or |
| The social account behind the source, with |
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|