API / 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.
List Posts
Returns a JSON list of the Posts in a Curator Feed.
Request
Required Params
FEED_ID
Feed API Key or Feed Public Key
Optional Params
limit
Limits the number of posts returned - defaults to 25, max is 100offset
Page offset - used to paginate through the resultsnetwork_id
Filter by a specific Network IDsource_type
Filter by a specific Source Type IDstatus
Filter by specific Post status - 1=all active posts, 0=all disabled posts, all = all posts
Response
{ "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": [] }
List Posts
Returns a JSON list of the Posts in a Curator Feed.
Request
Required Params
FEED_ID
Feed API Key or Feed Public Key
Optional Params
limit
Limits the number of posts returned - defaults to 25, max is 100offset
Page offset - used to paginate through the resultsnetwork_id
Filter by a specific Network IDsource_type
Filter by a specific Source Type IDstatus
Filter by specific Post status - 1=all active posts, 0=all disabled posts, all = all posts
Response
{ "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": [] }
List Posts
Returns a JSON list of the Posts in a Curator Feed.
Request
Required Params
FEED_ID
Feed API Key or Feed Public Key
Optional Params
limit
Limits the number of posts returned - defaults to 25, max is 100offset
Page offset - used to paginate through the resultsnetwork_id
Filter by a specific Network IDsource_type
Filter by a specific Source Type IDstatus
Filter by specific Post status - 1=all active posts, 0=all disabled posts, all = all posts
Response
{ "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": [] }