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
{
  "postCount": 1,
  "posts": [
    {
      "id": 460,
      "network_id": 2,
      "status": 1,
      "flagged": 0,
      "has_media": 0,
      "source_type": 4,
      "source_identifier": "599710470306835805_672103626",
      "source_created_at": "2013-11-29 07:44:40",
      "user_screen_name": "curator_io",
      "user_full_name": "Curator",
      "user_image": "https://example.com/user_image.jpg",
      "text": "Deck the halls #Xmas #christmas #decorations #westfield",
      "image": "https://example.com/image.jpg",
      "video": null,
      "url": "https://www.instagram.com/p/abcd1234/",
      "userUrl": "",
      "thumbnail": "",
      "video_width": 0,
      "video_height": 0,
      "network_name": "Instagram"
    }
  ]
}

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