Curator API: Create a post
POST https://api.curator.io/v1/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). You can only add posts to feeds in the account the key belongs to.
Example request
curl -X POST "https://api.curator.io/v1/posts?api_key=API_KEY" \
-d "feed_id=FEED_API_ID" \
-d "user_screen_name=curator" \
-d "user_full_name=Curator" \
-d "text=Our summer collection is here" \
-d "image=https://example.com/summer.jpg" \
-d "url=https://example.com/summer"Parameters
Parameter | Description |
|---|---|
| The feed's API ID or public key. |
| Author handle shown on the post, up to 200 characters. |
| Author display name. |
| URLs of the author's profile image and profile. |
| Post text. |
|
|
| URL of the post image. |
| Video URL, its size in pixels, and the URL of its preview image. |
| Link the post points to. |
| Location of the post. |
|
|
|
|
Other fields are ignored. The post's created date is set to the time of the request, and it has no network, so network_id is 0.
Response
A 200 response is the new post, with the fields described in the post object section of Curator API: Posts. Use its id to find the post later.
If the feed's API responses are cached, the new post appears in GET /v1/feeds/{feed_id}/posts once the cache expires. The feed object's cache_time shows how long that is, in minutes.
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
422 |
| A validation message with an |
429 | When rate limiting is enabled, more than 60 requests per minute. |
|