API documentation

Documentation

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

ParamDescription
FEED_IDFeed API Key or Feed Public Key

Optional Params

ParamDescription
limitLimits the number of posts returned - defaults to 25, max is 100
offsetPage offset - used to paginate through the results
network_idFilter by a specific Network ID
source_typeFilter by a specific Source Type ID
statusFilter by specific Post status - 1=all active posts, 0=all disabled posts, all = all posts