Platform Changelog

Oct 15, 2019

New Client registration and permission review on Instagram API platform are discontinued in favor of the Instagram Basic Display API. The existing clients will stop working on March 02, 2020.

Dec 11, 2018

Deprecation of Hashtags and Locations endpoints. For details about Hashtag search feature on Instagram Graph API, check here.

  • Hashtags
    • GET /tags/{tag-name}
    • GET /tags/{tag-name}/media/recent
    • GET /tags/search
  • Locations
    • GET /locations/{location-id}
    • GET /locations/{location-id}/media/recent
    • GET /locations/search
    • GET /media/search

April 4, 2018

The following endpoints are deprecated immediately:

  • Follows and Relationships
    • GET /users/self/follows
    • GET /users/self/followed-by
    • GET /users/self/requested-by
    • GET /users/{user-id}/relationship
    • POST /users/{user-id}/relationship
  • Commenting on Public Content
    • GET /media/{media-id}/comments (Deprecation not relevant when fetching comments for self media)
    • POST /media/{media-id}/comments
    • DEL /media/{media-id}/comments/comment-id
  • Media
    • GET /media/{media-id}
    • GET /media/shortcode/{shortcode}
  • Likes
    • GET /media/{media-id}/likes
    • POST /media/{media-id}/likes
    • DEL /media/{media-id}/likes
  • User Search
    • GET /users/{user-id}
    • GET /users/{user-id}/media/recent
    • GET /users/self/media/liked
    • GET /users/search
  • Subscriptions - to receive notifications when media is posted
  • Some information on Public Content returned through hashtag and location search will be removed - Name, Bio, Comments, Commenters, Follower Count, Following Count, Post Count, and Profile Picture

Oct 1, 2017

  • Updated Permission Review - new apps may only request basic permissions.

August 18, 2017

  • Added is_business field to /users/self.

Apr 18, 2017

  • Support for carousel formats.

Jun 1, 2016

Apr 20, 2016

  • Deprecation of foursquare_id and foursquare_v2_id parameters for /location/search.

Nov 17, 2015

  • Updated Platform Policy
  • Permission Review mandatory for every app
  • Apps created before Nov 17, 2015
    • Unaffected by new API behavior until June 1, 2016
    • Have until June 1, 2016 to be approved, or will be switched to Sandbox mode automatically
  • Apps created on or after Nov 17, 2015
    • Start in Sandbox mode for dev & test
    • Need to be reviewed and permission scopes approved before used in production
    • All API endpoints require a valid access_token
    • All API endpoints require a specific permission scope granted by the user
    • New follower_list permission scope
    • New public_content permission scope
    • New rate limits for Sandbox and Live apps
    • Private content only available to content owner
    • Deprecation of /users/self/feed
    • Deprecation of /media/popular
    • Deprecation of /geographies/media/recent
    • Deprecation of Realtime subscriptions for tags, locations and geographies
    • Deprecation of /users/USER-ID/follows and /users/USER-ID/followed-by
    • New endpoints: /users/self, /users/self/follows, /users/self/followed-by
    • API responses containing media objects no longer return the data field in comments and likes nodes.

Sept 3, 2015

  • Support for landscape and portrait formats

Sept 1, 2015

  • Deprecation of signed-headers

Aug 5, 2015

  • Removing pre-filled captions from mobile sharing

May 5, 2015

  • Removed empty 'bio' and 'website' fields from mini user bundles

Apr 14, 2015

  • New guidelines for POSTing likes and relationships
  • Introducing signed-requests

Oct 6, 2014

  • Update to Embedded posts and oEmbed endpoint

Jul 29, 2014

  • /oembed returns correct images when using maxheight or maxwidth parameters
  • /tags/{tagname}/media/recent returns correct pagination parameters max_tag_id and min_tag_id

Jul 19, 2014

  • New guidelines for POSTing comments
  • Comments API access form

Jun 3, 2014

  • Introducing security options to help better secure API requests
  • Revised rate limits on POSTs
  • Support for HTTP 429 Status Code (Rate limit exceeded).
  • Updated Python and Ruby libraries to support new options and limits

May 16, 2014

  • Instagram Python SDK release

Apr 24, 2014

  • Instagram Ruby SDK release