Se actualizó este documento.
La traducción en español no está disponible todavía.
Actualización del documento en inglés: 4 de sep.
Actualización del documento en español: 28 jul. 2022

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

Reels

Se aplica a todas las versiones.

Las respuestas GET /{user-id}/media ahora incluyen reels de video. Sin embargo, por el momento no hay manera de determinar si un video incluido en la respuesta se designó como reel.

June 27, 2022

Documentación sobre la API heredada de Instagram

Se aplica a todas las versiones.

Se eliminó la documentación para desarrolladores sobre la API heredada de Instagram y ahora redirecciona a la documentación para desarrolladores de la plataforma de Instagram.

August 30, 2021

Actividad fuera de Facebook

Se aplica a todas las versiones.

A mediados de julio, se pusieron en pausa los cambios del 15 de junio de 2021 relacionados con la configuración de la actividad futura y la desvinculación del historial, pero ya se reanudaron.

June 30, 2021

Tokens de acceso para las cuentas privadas

Se aplica a todas las versiones.

Ahora es posible actualizar los tokens de larga duración para las cuentas privadas de Instagram. Asimismo, los permisos que los usuarios de la app con cuentas privadas otorgan a las apps tienen ahora una validez de 90 días.

June 15, 2021

Actividad fuera de Facebook

Se aplica a todas las versiones.

Los usuarios que eliminen su historial o que desactiven su actividad futura invalidarán sus tokens de acceso. Asimismo, se les solicitará a los usuarios que desactivaron su actividad e intentaron usar la ventana de autorización que activen la actividad futura para que puedan usar la app.

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

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

January 14, 2020

December 6, 2019

October 15, 2019

Instagram Basic Display API has officially launched!