Curator API: Create a Post
POST https://api.curator.io/v1.3/posts adds your own post to a feed, such as an announcement or a photo that is not on a social network. 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). You can only add posts to feeds in the account the key belongs to.
Example request
curl -X POST "https://api.curator.io/v1.3/posts" \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{"feed_id": "FEED_ID", "user_screen_name": "curator", "text": "Our summer collection is here", "image": "https://example.com/summer.jpg"}'Parameters
Send parameters as JSON or form fields.
Parameter | Description |
|---|---|
| The feed's API ID or public key. The numeric feed ID is not accepted. |
| Author handle shown on the post, up to 200 characters. |
| Author display name. |
| Author image and profile URLs. |
| Post text. Curator detects HTML in it automatically. |
| Post image URL. |
| Video URL, its size in pixels, and its preview image URL. |
| Link the post points to. |
| Location of the post. |
| Network to show the post as. Default |
| A status number: |
|
|
Other fields, such as likes or comments, are ignored. The post's created date is the time of the request.
Response
A 200 response with the new post in data, with the fields described in Curator API: Get Posts, apart from data, images, media, and image_xlarge. Use its id with Curator API: Get a Post. The feed's cached responses are cleared, so the post shows up straight away.
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
422 |
|
|
422 | No feed in your account matches |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|