Curator API: Get Posts
GET https://api.curator.io/v1.2/feeds/FEED_ID/posts returns the posts in a feed as JSON, so you can render them yourself or pipe them into another system. The endpoint is public and needs no API key. Only HTTPS is supported.
Authentication
None. The endpoint works without an API key, and sending one changes nothing in the response.
Example request
curl "https://api.curator.io/v1.2/feeds/FEED_ID/posts?limit=25"GET https://api.curator.io/v1.2/feed/FEED_ID/posts returns the same response.
Parameters
Parameter | Description |
|---|---|
| The feed's public key or its API ID (both UUIDs). The numeric feed ID is not accepted. |
| Number of posts to return, between 1 and 100. Default 100. Values above 100 return 100, negative values return 1, and |
| Number of posts to skip. Ignored when |
| Cursor from a previous response's |
| Cursor from a previous response's |
|
|
| Default |
|
|
| Only posts whose author name or handle contains this value. |
| Only posts whose text contains this value. |
| Only posts from these networks, as a comma-separated list of network IDs. |
| Only posts from these sources, as a comma-separated list of the source IDs shown in the response's |
| Only posts of this source type ID. |
| Any value other than |
| Any value other than |
| Only posts updated in Curator after this date and time. |
| Only posts created on their network on or after, and on or before, this date. |
| Only posts tagged within |
| Pass |
Filters combine, so every post returned matches all of them.
Response
A 200 response looks like this:
{
"cache": { "status": "miss", "key": "...", "time": 5 },
"success": true,
"networks": [8],
"sources": [{ "name": "The Cars - Topic", "id": 46, "network_id": 8 }],
"pagination": {
"before": "eJwVy7EK...",
"after": "eJwVy7EK...",
"before_link": "https://api.curator.io/v1.2/feeds/FEED_ID/posts?limit=2&before=eJ...",
"after_link": "https://api.curator.io/v1.2/feeds/FEED_ID/posts?limit=2&after=eJ..."
},
"account": { "plan": { "unbranded": 1 } },
"postCount": 70,
"posts": [ { ... } ],
"v": "2"
}Field | Description |
|---|---|
|
|
| Always |
| Network IDs of the feed's sources. |
| Every source in the feed, with |
| Cursors and ready-made links for the newer and older pages. See Paginating with cursors. |
|
|
| Number of posts that match the filters, before paging. |
| The posts for this page. |
| Response format version, |
When account.plan.unbranded is 0, the second post in posts is a "Powered by Curator.io" post with id 1 and the text Powered by Curator.io, unless you pass hasPoweredBy=true. It is not counted in postCount.
Post object
Flags are integers: 0 for no, 1 for yes.
Field | Description |
|---|---|
| Post ID. |
| The network the post came from, such as 2 and |
| Status code and name, such as 1 and |
| Whether the post is flagged. |
| Source type ID, and the post's ID on its network. |
| When the post was created on its network, in UTC. |
| Post text, and whether it contains HTML. |
| Author handle and display name. |
| Author image and profile URLs. When there is no author image, |
| Post image URL, or empty. |
| Larger image URLs. Both fall back to |
| Image sizes in pixels, when known. |
| Media flags. |
| Extra images, such as carousel images, each with |
| Media files, each with |
| Video URL, size, and preview image. |
| Link to the original post. |
| Engagement counts from the network. |
| Post type flags. |
| Original author and post, when the post is a repost. |
| Whether the post is pinned, and when. |
| Location, when the post has one. Coordinates are strings, such as |
| Extra details from the network as |
| Deletion time, when set. |
Paginating with cursors
Follow pagination.after_link to get the next, older page, and pagination.before_link to go back to newer posts. The links keep your filters. If you build the URL yourself, send the same filters again with the cursor, because cursors do not carry them.
Cursors are always present, even on the last page. Stop when posts has fewer posts than your limit. sort_by=random does not support paging.
Errors
Status | When | Body |
|---|---|---|
404 | No feed has that public key or API ID. |
|
429 | When rate limiting is enabled, more than 300 requests per minute. |
|
500 | A cursor was changed or cut short. |
|