API documentation
Documentation
Docs navigation
API navigation
Posts
Returns a JSON feed / wall / channel of social media Posts that can be integrated into a widget, displayed on your website, displayed on a digital TV, queried via an API, et cetera, et cetera, and so forth.
Methods
List Posts
List Posts
Returns a JSON list of the Posts in a Curator Feed.
GET /feeds/FEED_ID/posts
Request
GET /v1/feeds/FEED_ID/posts
Response
- The response is a JSON object containing two variables:
- postCount - the number of posts in the feed
- posts - an array of Posts
- networks - an array of Network IDs
- pagination - an array of pagination keys for before and after
{
"cache": {
"status": "miss",
"key": "/v1/feeds/aa6b8e91-q3e5-445f-9be8-9f38b8b3e3f3/posts",
"time": 5
},
"success": true,
"pagination": {
"after": "eyJwaW5uZWQiOjAsInNvdXJjZV9jcmVhdGVkX2F0IjoiMjAyMy0wOS0yMVQwMDo0NTozNy4wMDAwMKidqhF=",
"before": "eyJwaW5uZWQiOjAsInNvdXJjZV9jcmVhdGVkX2F0IjoiMjAyNC0xMi0wNVQwMToyNjozMy4wMDAwMjOKaqU="
},
"networks": [
2,
3
],
"sources": [
{
"name": "@curatoruser",
"id": 228698,
"network_id": 2
},
{
"name": "Golden Retrievers",
"id": 228699,
"network_id": 3
}
],
"postCount": 2,
"posts": [
{
"id": 362389745,
"network_id": 2,
"status": 1,
"flagged": 0,
"has_media": 1,
"source_type": 34,
"source_identifier": "18030458648400723",
"source_created_at": "2024-12-05T01:26:33.000000Z",
"post_user_id": 0,
"user_screen_name": "curatoruser",
"user_full_name": "curatoruser",
"user_image": "https://curator-assets.b-cdn.net/538d0de0-a222-4611-80f8-1f897dd0c1e7/362334545_user_image.jpg?width=100&quality=75",
"text": "@curatoruser",
"is_html": 0,
"image": "https://curator-assets.b-cdn.net/538d0de0-a222-4611-80f8-1f897dd0c1e7/362334545.jpg?width=480&quality=75",
"video": "",
"url": "https://www.instagram.com/p/mnUOLKJaq/",
"user_url": "https://www.instagram.com/curatoruser",
"thumbnail": "",
"video_width": 0,
"video_height": 0,
"comments": 0,
"views": 0,
"is_repost": 0,
"is_reply": 0,
"is_edited": 0,
"is_embed": 0,
"likes": 0,
"originator_user_screenname": "",
"originator_user_url": "",
"originator_post_url": "",
"pinned": 0,
"pinned_at": null,
"longitude": "0.000000",
"latitude": "0.000000",
"location_name": "",
"image_width": 612,
"image_height": 612,
"image_processed": 1,
"has_image": 1,
"has_video": 0,
"image_large": "https://curatorio.s3.amazonaws.com/538d0de0-a333-4611-80f8-1f897dd0c1e7/362334545.jpg",
"image_large_width": 0,
"image_large_height": 0,
"deleted_at": null,
"network_name": "Instagram",
"post_status": "approved",
"data": [],
"images": [],
"media": [],
"spots": [],
"source_id": "1d6fb7a7-6fa0-42aa-8a3f-a2522473a15e",
"feed_id": "aa6b8e91-9f0f-445f-9be8-9f38b8b3e3f3",
"last_modified": "2024-12-16 06:21:36"
},
{
"id": 362678524,
"network_id": 3,
"status": 1,
"flagged": 0,
"has_media": 0,
"source_type": 5,
"source_identifier": "102557557612025_122166647126069354",
"source_created_at": "2024-11-13T17:16:52.000000Z",
"post_user_id": 0,
"user_screen_name": "102557557612025",
"user_full_name": "Golden Retrievers",
"user_image": "https://curator-assets.b-cdn.net/538d0de0-a333-4611-80f8-1f897dd0c1e7/362334524_user_image",
"text": "this is a test",
"is_html": 0,
"image": "",
"video": "",
"url": "https://www.facebook.com/122564332864056845/posts/122166647126069354",
"user_url": "https://www.facebook.com/102557557612025",
"thumbnail": "",
"video_width": 0,
"video_height": 0,
"comments": 0,
"views": 0,
"is_repost": 0,
"is_reply": 0,
"is_edited": 0,
"is_embed": 0,
"likes": 0,
"originator_user_screenname": "",
"originator_user_url": "",
"originator_post_url": "",
"pinned": 0,
"pinned_at": null,
"longitude": "0.000000",
"latitude": "0.000000",
"location_name": "",
"image_width": 0,
"image_height": 0,
"image_processed": 0,
"has_image": 0,
"has_video": 0,
"image_large": "",
"image_large_width": 0,
"image_large_height": 0,
"deleted_at": null,
"network_name": "Facebook",
"post_status": "approved",
"data": [],
"images": [],
"media": [],
"spots": [],
"source_id": "6a7dab7f-7ad2-4567-95c0-7a7f4c8e15f7",
"feed_id": "aa6b8e91-9f0f-123d-9be8-9f38b8b3e3f3",
"last_modified": "2024-12-16 06:21:20"
}
],
"ads": []
}
Params
Param | Description |
---|---|
FEED_ID | Feed API Key or Feed Public Key |
Optional Params
Param | Description |
---|---|
limit | Limits the number of posts returned - defaults to 25, max is 100 |
offset | Page offset - used to paginate through the results |
network_id | Filter by a specific Network ID |
source_type | Filter by a specific Source Type ID |
status | Filter by specific Post status - 1=all active posts, 0=all disabled posts, all = all posts |