Curator API: Feeds
The /v1/feeds endpoints let you list, create, rename, and delete the feeds in your Curator account. Every 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 can only see and change that account's feeds.
Endpoints
Method and path | What it does |
|---|---|
| Lists every feed in your account. |
| Creates a feed. |
| Renames a feed. |
| Deletes a feed. |
To read a feed's posts, use GET /v1/feeds/{feed_id}/posts, covered in Curator API: Posts. GET /v1/feeds/{feed_id} is an alias of that endpoint and returns posts, not the feed's settings.
List feeds
curl "https://api.curator.io/v1/feeds?api_key=API_KEY"Returns a JSON array of feed objects, with no wrapper and no pagination.
Create a feed
curl -X POST "https://api.curator.io/v1/feeds?api_key=API_KEY" \
-d "name=Homepage feed"Parameter | Description |
|---|---|
| Feed name, up to 200 characters. |
| The widget layout the feed starts with, such as |
| Status new posts get when they arrive: |
Returns the new feed object. The new feed gets its own API ID and public key, and its caching settings come from your plan.
Rename a feed
curl -X PUT "https://api.curator.io/v1/feeds/FEED_API_ID?api_key=API_KEY" \
-d "name=Homepage feed (2025)"Parameter | Description |
|---|---|
| The feed's API ID (a UUID). The public key is not accepted here. |
| The new feed name. |
| Status new posts get when they arrive: |
Returns the updated feed object. Use the Curator Dashboard for design and widget settings.
Delete a feed
curl -X DELETE "https://api.curator.io/v1/feeds/FEED_API_ID?api_key=API_KEY"feed_id is the feed's API ID. A successful delete returns:
{ "success": true, "message": "Feed deleted" }Feed object
Feed objects include the fields below, plus widget configuration fields that the Curator Dashboard manages.
Field | Description |
|---|---|
| The feed's API ID (a UUID). Use it in the feed endpoints and when adding sources or posts. |
| The feed's public key, used by the embed code and accepted by |
| Feed name. |
| URL-friendly version of the name. |
| Status new posts get: |
| The feed's widget layout and theme. |
| Number of posts in the feed. |
| Whether API responses for the feed are cached, and for how many minutes. |
| Whether the feed's embedded widget has loaded posts at least once. |
| Whether the feed uses the current widget version. |
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
404 | Delete only: no feed with that API ID in your account. |
|
422 | Rename: no feed with that API ID in your account. Create or rename: |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|