Changelog

September 4, 2024

Announcing deprecation of Instagram Basic Display API. In 90 days, on December 4, 2024, the Instagram Basic Display API will no longer be available.

June 28, 2022

June 27, 2022

August 30, 2021

June 30, 2021

June 15, 2021

June 8, 2021

Access Token Debugger

Applies to all versions.

The access token debugger tool now only returns an app-scoped ID when debugging a token.

API Versioning

Applies to all versions.

The API now supports versioned calls. To query a specific API version include the version number in the query path after the base URL. For example:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

Un-versioned requests (missing the version number) resolve to the version specified in the calling app's App Dashboard > Settings > Advanced > Upgrade API Version section.

App Scoped User IDs

Applies to version 11.0+.

App-scoped user IDs (ASIDs) have been introduced. ASIDs will replace raw user IDs in approximately two years, when version 10.0 is deprecated, so we recommend that you begin mapping your app users' raw IDs to their ASID equivalents.

• All versions support raw user ID based queries.
• Only version 11.0+ calls support ASID based queries.
• Version 11.0+ calls will receive ASIDs in responses, even when querying raw user IDs.

Time-based Pagination

Applies to v11.0+.

Added since and until parameters to the GET /{user-id}/media endpoint to support time-based pagination.

October 24, 2020

• User Node — The ig_id field, which returned the app user's Instagram Legacy User ID, has been deprecated.

August 31, 2020

• Private Accounts — Long-lived access tokens for private Instagram accounts can no longer be refreshed. In addition, if an app user switches their account from public to private, their token will be invalidated and a new token must be requested.

June 5, 2020

• Legacy IDs — You can now request the ig_id field on the User node to get the app user's Instagram Legacy API User ID. This field will be available until September 30th, 2020. (UPDATE: Available until October 24, 2020).

February 20, 2020

• Instagram User Token Generator — You can now use the Instagram User Token Generator to quickly generate long-lived Instagram User Access Tokens for any of your public Instagram accounts.

January 14, 2020

• Long-Lived Access Tokens — Long-lived Instagram User Access Tokens are no longer in beta.

December 6, 2019

• Long-Lived Access Tokens (Beta) — You can now get long-lived Instagram User Access Tokens which are valid for 60 days and can be refreshed.
• Token Debugger — The Access Token Debugger tool now supports Instagram User Access Tokens.

October 15, 2019

Instagram Basic Display API has officially launched!