Curator API: Get Feeds
GET https://api.curator.io/v1.2/feeds returns every feed in your Curator account as JSON. 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 feeds.
Example request
curl "https://api.curator.io/v1.2/feeds?api_key=API_KEY"Response
A 200 response is a JSON array of feed objects, with no wrapper, no paging, and no set order.
Feed object
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
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. |
|