Skip to content
This repository

Timeline resources

All timeline types share the same response format:

{
  "items": [
    <media>,
    ...
  ],
  "num_results": 32,
  "status": "ok"
}

Personal timeline

GET http://instagr.am/api/v1/feed/timeline/

Items returned: 30.

Popular timeline (unauthenticated)

GET http://instagr.am/api/v1/feed/popular/

Items returned: 32.

User's timeline (unauthenticated)

GET http://instagr.am/api/v1/feed/user/<ID>/

Items returned: 20.

Params:

  • max_id: fetch records until ID given

The "max_id" param is used for pagination. To get the next page, use the last item's "pk" as a value for "max_id". This parameter has no effect in the "popular" timeline.

User's timeline in JSONP for cross-site requests (unauthenticated)

If you need to fetch a user's timeline in your client-side JavaScript, your only option is JSONP since Ajax is limited with the same-origin request policy.

Instagram API doesn't support JSONP, but you can use instagram.heroku.com which acts as a JSON proxy site:

GET http://instagram.heroku.com/users/<ID>.json?_callback=<NAME>

Example response if the callback was named "myInstagram":

myInstagram({"items":[...]})

This is designed so can use the above resource in combination with the dynamic SCRIPT tag.

Location-based timeline (unauthenticated)

GET http://instagr.am/api/v1/feed/location/<ID>/

Gets all medias taken at the location specified by ID. The location ID is the value of the "location.pk" key in a media.

Something went wrong with that request. Please try again.