Instagram

  • Log in
  • Overview
  • Authentication
  • Real-time
  • iPhone Hooks
  • API Console
  • Endpoints
  • Embedding
  • Libraries
  • Forum

Embedding Endpoints

We provide two simple ways to get information about a shared link in order to display a preview: an OEmbed endpoint and a simple URL append endpoint. Neither requires an access_token or client_id.

  • GET /oembed Returns info about the media associated with a url.
  • GET /p/shortcode/media Issues a redirect to that media's JPG file.

GET /oembed

  • Response
http://api.instagram.com/oembed?url=http://instagr.am/p/BUG/
{
    "author_id": 72,
    "author_name": "danrubin",
    "author_url": "http://instagram.com/",
    "height": 612,
    "media_id": "5382_72",
    "provider_name": "Instagram",
    "provider_url": "http://instagram.com/",
    "title": "Rays",
    "type": "photo",
    "url": "http://distillery.s3.amazonaws.com/media/2010/10/02/7e4051fdcf1d45ab9bc1fba2582c0c6b_7.jpg",
    "version": "1.0",
    "width": 612
}

Given a short link, returns information about the media associated with that link.

Parameters
url A short link, like http://instagr.am/p/BUG/.
callback A JSON callback to be invoked.
maxheight Maximum height of returned media.
maxwidth Maximum width of returned media.

GET /p/shortcode/media

  • Response
http://instagr.am/p/BUG/media/?size=t
HTTP/1.1 302 FOUND
Location: http://distillery.s3.amazonaws.com/media/2010/10/02/7e4051fdcf1d45ab9bc1fba2582c0c6b_6.jpg

Given a short link, issues a redirect to that media's JPG file.

Parameters
size One of t (thumbnail), m (medium), l (large). Defaults to m.
  • About us
  • Support
  • Blog
  • API
  • Jobs
  • Privacy
  • Terms

© 2013 Instagram