Curator API: Get Sources
GET https://api.curator.io/v1.3/sources returns the sources in your Curator account as JSON, one page at a time. 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, with Bearer capitalised). The key decides which account you are working in; you only see that account's sources.
Example request
curl "https://api.curator.io/v1.3/sources?feed_id=FEED_ID&status=active" \
-H "Authorization: Bearer API_KEY"Parameters
Parameter | Description |
|---|---|
| Only sources in this feed, by the feed's API ID. |
| Only sources that use this connection, by the connection's API ID. |
| Only sources with this status: |
| Sources per page, between 1 and 100. Default 15. Larger values return 100, and |
| Cursors from |
Empty parameters are ignored.
Response
A 200 response has the sources in data, oldest first, and paging details in meta.pagination:
{
"data": [
{
"id": "SOURCE_ID",
"feed_id": "FEED_ID",
"source_type": { "id": 16, "network_id": 10, "network_connection_id": 0, "name": "RSS", ... },
"network_id": 10,
"company_connection_id": 0,
"status": "active",
"tag": "https://news.ycombinator.com/rss",
...
"account": null
}
],
"meta": {
"success": true,
"pagination": { "per_page": 15, "after": null, "before": null, "after_link": null, "before_link": null }
}
}Paginating with cursors
Follow meta.pagination.after_link for the next page and before_link for the previous one. The links keep your filters but leave out api_key, so send the key in a header or add it again. after is null on the last page and before is null on the first.
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 number |
|
|
| 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, or |
Errors
Errors use the same wrapper, with data set to null and the reason in meta.message.
Status | When | Body |
|---|---|---|
400 | Both |
|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
404 | No feed or connection in your account matches |
|
422 |
|
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|