Curator API: Get Posts
GET https://api.curator.io/v1.3/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.3/feeds/FEED_ID/posts?limit=25"GET https://api.curator.io/v1.3/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 per page, between 1 and 100. Default 100. Values above 100 return 100 and negative values return 1. This endpoint uses |
| Number of posts to skip. Ignored when |
| Cursor from |
| Cursor from |
|
|
| 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 |
| Only posts of this source type ID. |
| 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 has the posts in data and everything else in meta:
{
"data": [ { ... }, { ... } ],
"meta": {
"success": true,
"total_count": 70,
"pagination": {
"before": "eJwVy7EKgCAU...",
"after": "eJwVy7EKgCAU...",
"before_link": "https://api.curator.io/v1.3/feeds/FEED_ID/posts?limit=2&before=eJwV...",
"after_link": "https://api.curator.io/v1.3/feeds/FEED_ID/posts?limit=2&after=eJwV..."
},
"cache": { "status": "miss", "key": "...", "time": 5 },
"networks": [8],
"sources": [ { "name": "The Cars - Topic", "id": 46, "network_id": 8 } ],
"account": { "plan": { "unbranded": 1 } },
"v": "2"
}
}Field | Description |
|---|---|
| Number of posts that match the filters, before paging. |
| Cursors and ready-made links for the older and newer pages. See Paginating with cursors. |
|
|
| Network IDs of the feed's sources. |
| Every source in the feed, with |
|
|
| Response format version, |
When meta.account.plan.unbranded is 0, the second post in data is a "Powered by Curator.io" post with id 1, unless you pass hasPoweredBy=true. It is not counted in total_count.
Post object
Flags are integers: 0 for no, 1 for yes.
Field | Description |
|---|---|
| Post ID, a number. |
| The network the post came from, such as 8 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 meta.pagination.after_link to get the next, older page. The links keep your filters. If you build the URL yourself, send the same filters again with the cursor.
after is null on the last page, so stop when it is. before is never null; going back from the first page returns an empty data array. sort_by=random does not support paging: after is always set and each page is a new random selection.
Errors
Errors use the same wrapper, with data set to null and the reason in meta.message, except the 500.
Status | When | Body |
|---|---|---|
400 | Both |
|
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. |
|