Plataforma de Instagram
Volver al documento en español
Se actualizó este documento.
La traducción en español no está disponible todavía.
Actualización del documento en inglés: 12 de sep.
Actualización del documento en español: 5 de ago.

Changelog for Instagram Platform

This changelog refers to changes made for the Instagram APIs.

Related Changelogs

September 17, 2024

New scope values

Applies to all versions.

To ensure consistency between scope values and permission names, we are introducing new scope values for the Instagram API with Instagram login. The new scope values are:

  • instagram_business_basic
  • instagram_business_content_publishing
  • instagram_business_manage_comments
  • instagram_business_manage_messages

These will replace the existing business_basic, business_content_publishing, business_manage_comments and business_manage_messages values, respectively.

Please note that the old scope values will be deprecated on December 17, 2024. It is essential to update your code before this date to avoid any disruption in your app's functionality. Failure to do so will result in your app being unable to call the Instagram endpoints.

July 23, 2024

Launch of the new Instagram API with Instagram Login

Components of this new Instagram API:

  • A Facebook Page will no longer be required
  • The host URL for API calls is graph.instagram.com
  • New permissions for this API:
    • instagram_business_basic
    • instagram_business_content_publishing
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • The Messenger API will no longer be used to send Instagram messages
  • New apps will add the new Instagram product when creating a Meta app
  • Existing apps can add the new Instagram product in the App Dashboard

Visit our migration guide to learn if this new Instagram API with Instagram Login is right for you.

June 11, 2024

Instagram Comment Webhooks

Applies to all versions.

In addition to the ad_id and ad_title, the original_media_id will be returned in the media object of the comments field's value object when a person comments on a boosted Instagram post or Instagram ads post. For more information, refer to Set Up Webhooks for Instagram.

May 21, 2024

Instagram User Insights

Applies to v20.0+. Will apply to all versions on August 19, 2024.

The last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.

The following endpoints and metrics are affected:

September 12, 2023

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

November 9, 2022

Instagram Webhooks

Applies to all versions.

The ad_id and ad_title will be returned in the media object of the comments field's value object when a person comments on a boosted Instagram post or Instagram ads post.

October 31st

Reels – Product Tags

Applies to all versions.

Instagram Product Tagging API for Reels is made available. You can tag up to 30 products when publishing a reel.

June 28, 2022

Reels

Applies to all versions.

Reels are now supported. To publish a video as a reel, set the media_type parameter to REELS when creating a single media post container. Refer to the POST /ig-user/media endpoint reference to learn which parameters can be used with reels as well as requirements for reels videos.

Note: Beginning November 9, 2023, the VIDEO value for media_type will no longer be supported. Use the REELS media type to publish a video to your feed.

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.

June 20, 2022

Etiquetado de productos

Se aplica a todas las versiones.

Ahora puedes crear y administrar etiquetas de compra de productos en Instagram en contenido multimedia publicado por una empresa en esta red. Consulta la guía Etiquetado de productos para descubrir cómo hacerlo.

May 27, 2022

Product Variants

Applies to all versions.

For partners in the Product Tagging beta, all product variants that match a query's search criteria will now be returned when searching a catalog for products.

March 15, 2022

Publicaciones por secuencia

Se aplica a todas las versiones.

Ahora puedes usar la API de Instagram para hacer publicaciones con varios videos e imágenes (publicaciones por secuencia). Consulta la guía sobre publicación de contenido si deseas conocer todos los pasos que se deben seguir para realizar una publicación.

Si tu app ya cuenta con los permisos necesarios para publicar contenido, no es necesario volver a realizar la revisión de apps para aprovechar esta funcionalidad.

November 9, 2021

Videos en vivo

Se aplica a todas las versiones.

Ahora, puedes usar la API de Instagram para obtener contenido multimedia de Instagram de los videos en vivo que están transmitiendo los usuarios de tu app, obtener los comentarios de esos videos y usar la API de mensajes de Instagram para enviar respuestas privadas (mensajes directos) a los autores de los comentarios. Para admitir esta funcionalidad, se realizaron los siguientes cambios:

  • Un nuevo perímetro GET /ig-user/live_media puede devolver el contenido multimedia de Instagram de videos en vivo que está transmitiendo el usuario de tu app al momento de la solicitud.
  • Ahora, el campo media en un comentario de Instagram devuelve un objeto que contiene tanto el identificador (id) como la ubicación de publicación (media_product_type) del contenido multimedia sobre el cual se realizó el comentario.
  • Un nuevo campo live_comments de webhooks de Instagram puede enviar notificaciones con comentarios en vivo realizados en los videos en vivo de los usuarios de tu app mientras se transmiten.

Consulta la documentación sobre respuestas privadas de la API de mensajes de Instagram para obtener información sobre cómo enviar respuestas privadas a usuarios que hayan comentado en el contenido multimedia de Instagram de videos en vivo de los usuarios de la app.

October 20, 2021

Comentarios de Instagram

Se aplica a todas las versiones.

Se agregaron dos nuevos campos a los comentarios de Instagram:

  • from: devuelve un objeto que contiene el IGSID (id) y el nombre de usuario (username) del creador del comentario.
  • parent_id: devuelve el identificador del comentario principal de Instagram si dicho comentario se creó en otro comentario de Instagram (por ejemplo, una respuesta a otro comentario).

Webhooks de Instagram

Se aplica a todas las versiones.

El campo de webhooks comments de Instagram incluye ahora las siguientes propiedades en el objeto del campo value:

  • from.id: el IGSID del usuario de Instagram que creó el comentario.
  • from.username: el nombre de usuario del usuario de Instagram que creó el comentario.
  • media.id: identificador del contenido multimedia de Instagram sobre el que se hizo el comentario.
  • media.media_product_type: superficie (ubicación publicada) del contenido multimedia de Instagram sobre el que se hizo el comentario.
  • parent_id: el identificador del comentario principal de Instagram si dicho comentario se creó en otro comentario de Instagram (por ejemplo, una respuesta a otro comentario).

October 5, 2021

Los siguientes cambios se aplican a los videos de Instagram TV creados el 5 de octubre de 2021 o con posterioridad. Los videos de Instagram TV que se crearon antes de esa fecha quedan exceptuados de estos cambios.

  • El campomedia_product_type devolverá FEED en vez de IGTV.
  • El campovideo_title no se devolverá.
  • Ahora, se admiten los comments de los webhooks de Instagram y los campos mentions.

El 3 de enero de 2022, se aplicarán los cambios mencionados a todas las versiones de la API y a todos los videos de Instagram TV, sin importar cuándo se crearon. Esto significa que, a partir del 3 de enero de 2022, las apps que utilicen versiones anteriores de la API podrán solicitar videos de Instagram TV (se incorporó la compatibilidad de lectura en la versión 10.0 y, de manera limitada, en las versiones posteriores).

Se dejará de admitir, a partir de la versión 14.0, el campo video_title. La API mostrará un error si se solicita ese campo.

June 8, 2021

Like Counts

Applies to v11.0+. Will apply to all versions September 7, 2021.

If indirectly querying an IG Media through another endpoint or field expansion, the like_count field will be omitted from API responses if the media owner has hidden like counts on it. Directly querying the IG Media (which can only be done by the IG Media owner) will return the actual like count, however, even if like counts have been hidden.


Time-based Pagination

Applies to v11.0+.

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

May 26, 2021

Si se solicita de manera indirecta un contenido multimedia de IG a través de otro punto de conexión, el campo like_count devolverá ahora 0, siempre que el usuario de la app no sea propietario del contenido multimedia y el propietario del contenido multimedia tenga ahí conteos de Me guta ocultos. Solicitar de manera directa el contenido multimedia de IG, que solo el propietario del contenido multimedia de IG puede hacerlo, devolverá el conteo real de Me gusta, incluso si el propietario ocultó el conteo de Me gusta en el contenido multimedia.

May 4, 2021

Hicimos un cambio menor en la forma en que calculamos la métrica online_followers de los usuarios de IG.

April 14, 2021

Las interacciones con contenido multimedia de Instagram para historias realizadas por usuarios en Japón ya no se incluyen en algunos cálculos de la métrica replies:

  • En el caso de las historias creadas por usuarios de Japón, la métrica replies ahora devolverá el valor 0.
  • En el caso de las historias creadas por usuarios fuera de Japón, la métrica replies devolverá la cantidad de respuestas, pero el cálculo no incluirá las respuestas de los usuarios de Japón.

April 12, 2021

Fixed a minor bug with reach metrics on story IG Media.

April 9, 2021

March 16, 2021

IGTV media is now supported in v10.0+. This applies to all endpoints except those used for content publishing and webhooks. To support this change, new media_product_type and video_title fields have been added to the IG Media node. IGTV media must have been shared to Instagram at the time of publish (Post a Preview or Share Preview to Feed enabled) in order to be accessible via the API.

Januray 26, 2021

The Content Publishing beta has ended and all developers can now publish media on Instagram Professional accounts. Refer to the Content Publishing guide for usage details.

December 2, 2020

In compliance with the European Union's ePrivacy Directive, messaging-related Story IG Media interactions performed by users in the European Economic Area (EEA) after December 1, 2020, will no longer be included in some metric calculations:

  • For Stories created by users in the EEA, the replies metric will now return a value of 0.
  • For Stories created by users outside the EEA, the replies metric will return the number of replies, but replies made my users in the EEA will not be included in its calculation.

This change applies to all versions.

November 10, 2020

  • IG User Insights — The follower_count values now align more closely with their corresponding values displayed in the Instagram app. In addition, follower_count now returns a maximum of 30 days of data instead of 2 years. This change applies to v9.0+ and will apply to all versions May 9, 2021.

May 5, 2020

December 3, 2019

  • Insights — To align API behavior with Instagram app behavior, insights on IG Users are now only available on IG Users that have 100 or more followers.

August 13, 2019

  • Business Discovery — The Business Discovery API can now be used to get data about other Instagram Creator accounts.

May 22, 2019

May 9, 2019

  • Webhooks — The story_insights field now requires the instagram_manage_insights permission instead of instagram_manage_comments.

October 31, 2018

  • Hashtag Search API — You can now search for media tagged with specific hashtags by using our new Hashtag Search API. #spooky!

October 23, 2018

  • /{ig-media-id}/comments edge — GET requests made using API version 3.1 or older will have results returned in chronological order. Requests made using version 3.2+ will have results returned in reverse chronological order.

June 7, 2018

  • /{ig-media-id} node — You can now use field expansion to get the permalink field on media objects.

May 1, 2018

  • Business Verification — In order to use the Instagram Graph API, all apps must undergo Business Verification, which is part of the App Review process and now required for all Instagram Graph API endpoints. Apps previously reviewed before May 1st, 2018, have to be reviewed again, and have until August 1st, 2018 to do so, or lose access to the API.

April 24, 2018

  • /{ig-comment-id} node:
    • Added a new username field.
    • For GET requests, the user field will not be included in responses unless the User making the request owns the Comment; instead, we will return username for all commenters. This also applies to queries on Comments made through other APIs, such as the Mentions API.
  • /{ig-media-id} node:
    • Added a new username field.
    • For GET requests, the owner field will not be included in responses unless the User making the request owns the media object; instead, we will return username for all commenters. This also applies to queries on media objects made through other APIs, such as the Mentions API.

April 23, 2018

  • Insights API — Insights will now include ad activity generated through the API, Facebook ads interfaces, and Instagram's Promote feature. This affects the following metrics:

    • impressions
    • reach

March 13, 2018

  • Content Publishing API — Beta partners can now use the /{ig-user-id}/media edge to tag locations and public Instagram users when publishing photos.

March 8, 2018

  • Public fields — The timestamp field on the /{ig-media-id} node is now a public field and can be returned via field expansion.

February 22, 2018

  • Public fields — The /{ig-user-id}, /{ig-comment-id}, and /{ig-media-id} nodes will now return all public fields when accessed through an edge via field expansion. Refer to each node's reference document to see which fields are public.

February 8, 2018

  • Content Publishing API — Beta partners can now include hashtags when publishing photos via the /{ig-user-id}/media edge. #crazywildebeest FTW!