Curator API: Get Feeds
GET https://api.curator.io/v1.3/feeds returns the feeds in your Curator account as JSON, one page at a time. 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 feeds.
Example request
curl "https://api.curator.io/v1.3/feeds?per_page=25" \
-H "Authorization: Bearer API_KEY"Parameters
Parameter | Description |
|---|---|
| Feeds per page, between 1 and 100. Default 15. Larger values return 100, and |
| Cursor from |
| Cursor from |
Response
A 200 response has the feeds in data, oldest first, and paging details in meta.pagination:
{
"data": [ { "id": "FEED_ID", "name": "Default feed", ... } ],
"meta": {
"success": true,
"pagination": {
"per_page": 25,
"after": "eyJpZCI6MSwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
"before": null,
"after_link": "https://api.curator.io/v1.3/feeds?per_page=25&after=eyJpZCI6...",
"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 other query parameters 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.
Feed object
Flags are integers: 0 for no, 1 for yes.
Field | Description |
|---|---|
| The feed's API ID (a UUID). Use it, or |
| The feed's public key (a UUID), used by the embed code. |
| Feed name. |
| URL-friendly version of the name. |
| Feed type, such as |
| Moderation mode, such as |
| Status new posts get: |
| The widget layout and theme, such as |
| Widget settings, as JSON text. |
| The widget version, and whether it is the current one ( |
| Fallback post and author images, when set. |
| Extra settings as an object, or |
| Whether feed responses are cached, and for how many minutes. |
| Number of posts in the feed. |
| Whether the feed's embedded widget has loaded posts at least once. |
Feed objects also include other widget fields that the Curator Dashboard manages, such as widget_advanced_styles, colour_options, html_before, and html_after.
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. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|