Curator API: Create a Feed
POST https://api.curator.io/v1.2/feeds creates a feed in your Curator account. 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 feed is created in the account the key belongs to.
Example request
curl -X POST "https://api.curator.io/v1.2/feeds?api_key=API_KEY" \
-d "name=Homepage feed"Parameters
Send parameters as form fields or JSON.
Parameter | Description |
|---|---|
| Feed name, up to 200 characters. |
| The widget layout the feed starts with. Default |
| Status new posts get: |
| Fallback post and author image URLs. |
The new feed gets its own API ID and public key, and its caching settings come from your plan.
Response
A 201 response with the new feed. It only includes the fields that were set when the feed was created, so call Curator API: Get a Feed with its id to get the full feed object.
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
422 |
|
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|