Registro de cambios

Este registro de cambios incluye los cambios realizados en la API Graph de Instagram.

Registros de cambios relacionados

12 de septiembre de 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.

9 de noviembre de 2022

Webhooks de Instagram

Se aplica a todas las versiones.

Se devolverán ad_id y ad_title en el objeto media, que en el campo comments está en el objeto value, cuando una persona haga un comentario sobre una publicación de Instagram promocionada o una publicación de anuncios de Instagram.

31 de octubre

Reels - Etiquetas de producto

Se aplica a todas las versiones.

Ahora, está disponible la API de etiquetado de productos de Instagram para Reels. Puedes etiquetar hasta 30 productos cuando publicas un reel.

28 de junio de 2022

Reels

Se aplica a todas las versiones.

Ahora se admiten reels. Para publicar un video como reel, configura el parámetro media_type como REELS cuando crees un contenedor de una publicación solo de contenido multimedia. Consulta la referencia de POST /ig-user/media endpoint para conocer qué parámetros se pueden usar con reels y qué parámetros se pueden usar con videos de reels.

27 de junio de 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.

20 de junio de 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.

27 de mayo de 2022

Variantes de productos

Se aplica a todas las versiones.

Se devolverán a los socios de la versión beta de Etiquetado de productos todas las variantes de productos que coincidan con un criterio de búsqueda de la consulta cuando realicen búsquedas de productos en un catálogo.

15 de marzo de 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.

9 de noviembre de 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.

20 de octubre de 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).

5 de octubre de 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.

8 de junio de 2021

Conteo de Me gusta

Se aplica a partir de la versión 11.0 Se implementará en todas las versiones a partir del 7 de septiembre de 2021.

Si se consulta de forma indirecta un contenido multimedia de IG a través de otro punto de conexión o expansión de campos, el campo like_count se omitirá de las respuestas de la API, siempre que el propietario del contenido multimedia haya ocultado los Me gusta en él. Solicitar de manera directa el contenido multimedia de IG (algo que solo el propietario del contenido multimedia de IG puede hacer) devolverá el conteo real de Me gusta, incluso si se ocultó este conteo.


Paginación basada en el tiempo

Se aplica a la versión 11.0 y posteriores.

Se agregaron los parámetros since y until al punto de conexión GET /{ig-user-id}/media para admitir la paginación basada en el tiempo.

26 de mayo de 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.

4 de mayo de 2021

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

14 de abril de 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.

12 de abril de 2021

Se solucionó un error menor con las métricas de alcance en el contenido multimedia de Instagram para historias.

9 de abril de 2021

16 de marzo de 2021

A partir de la versión 10.0, se admite ahora el contenido multimedia de IGTV, lo que aplica a todos los puntos de conexión, con excepción de aquellos que se utilizan para publicar contenido y webhooks. Para lograr la compatibilidad con este cambio, se agregaron dos nuevos campos, media_product_type y video_title, al nodo contenido multimedia de Instagram. Es necesario haber compartido el contenido multimedia de IGTV en Instagram al momento de realizar la publicación (función Publicar una vista previa o Compartir una vista previa en el feed activada) para que esté disponible a través de la API.

26 de enero de 2021

Finalizó la versión beta de publicación de contenido, y todos los desarrolladores pueden publicar ahora contenido multimedia en cuentas de profesionales de Instagram. Consulta la guía Publicación de contenido para obtener información detallada sobre su uso.

2 de diciembre de 2020

En cumplimiento con la Directiva sobre la privacidad y las comunicaciones electrónicas de la Unión Europea, después del 1 de diciembre de 2020, ya no se incluirán en algunos cálculos de métricas las interacciones de contenido multimedia de IG en historias relacionadas con mensajes que realizan los usuarios que se encuentran en el Espacio Económico Europeo (EEE):

  • En el caso de las historias creadas por usuarios que se encuentran en el EEE, la métrica replies ahora mostrará un valor de 0.
  • En el caso de las historias creadas fuera del EEE, la métrica replies devolverá la cantidad de respuestas, pero el cálculo no incluirá las respuestas de los usuarios que se encuentran dentro del EEE.

Este cambio se aplica a todas las versiones.

10 de noviembre de 2020

  • Estadísticas del usuario de IG: los valores follower_count ahora se alinean más estrechamente con sus valores correspondientes que se muestran en la app de Instagram. Además, ahora follower_count devuelve un máximo de 30 días de datos en lugar de 2 años. Estos cambios se aplican a las versiones 9.0 en adelante, y se aplicarán a todas las versiones a partir del 9 de mayo de 2021.

5 de mayo de 2020

3 de diciembre de 2019

  • Estadísticas: para alinear el comportamiento de la API con el comportamiento de la app de Instagram, las estadísticas sobre los usuarios de IG ahora solo están disponibles para los usuarios de IG que tengan 100 o más seguidores.

13 de agosto de 2019

22 de mayo de 2019

9 de mayo de 2019

  • Webhooks: El campo story_insights ahora requiere el permiso instagram_manage_insights en lugar de instagram_manage_comments.

31 de octubre de 2018

  • API de búsqueda de hashtag: ahora puedes buscar contenidos multimedia etiquetados con hashtags específicos usando nuestra nueva API de búsqueda de hashtag. ¡#spooky!

23 de octubre de 2018

  • Perímetro /{ig-media-id}/comments: las solicitudes GET hechas con la versión 3.1 o más antigua de la API tendrán los resultados en orden cronológico. Las solicitudes que se hagan usando la versión 3.2 en adelante tendrán los resultados en orden cronológico inverso.

7 de junio de 2018

  • Nodo /{ig-media-id}: ahora puedes usar la expansión de campos para obtener el campo permalink en los objetos multimedia.

1 de mayo de 2018

  • Verificación del negocio: para usar la API Graph de Instagram, todas las aplicaciones deben someterse a una verificación del negocio, que forma parte del proceso de revisión de aplicaciones y ahora se requiere para todos los puntos de conexión de la API Graph de Instagram. Las aplicaciones que se revisaron antes del 1 de mayo de 2018 deben volver a revisarse antes del 1 de agosto del mismo año o perderán el acceso a la API.

24 de abril de 2018

  • Nodo /{ig-comment-id}
    • Se agregó un nuevo campo username.
    • En el caso de las solicitudes GET, el campo user no se incluirá en las respuestas a menos que el usuario que hace la solicitud sea el propietario del comentario; en su lugar, devolveremos username para todos los que comenten. Esto también se aplica a las consultas sobre los comentarios que se realizan a través de otras API, como la API Mentions.
  • Nodo /{ig-media-id}:
    • Se agregó un nuevo campo username.
    • En el caso de las solicitudes GET, el campo owner no se incluirá en las respuestas a menos que el usuario que hace la solicitud sea el propietario del objeto multimedia; en su lugar, devolveremos el username de cada usuario que haya comentado. Esto también se aplica a las consultas sobre objetos multimedia que se realizan a través de otras API, como la API Mentions.

23 de abril de 2018

  • API Insights: Insights incluirá ahora la actividad publicitaria que se genere a través de la API, de las interfaces de anuncios de Facebook y de la función Promote de Instagram. Esto afecta a las siguientes métricas:

    • impressions
    • reach

13 de marzo de 2018

  • API de publicación de contenidos: ahora puedes usar el perímetro /{ig-user-id}/media para etiquetar ubicaciones y usuarios públicos de Instagram al publicar fotos.

8 de marzo de 2018

  • Campos públicos: el campo timestamp en el nodo /{ig-media-id} es ahora un campo público y puede devolverse mediante la expansión de campos.

22 de febrero de 2018

  • Campos públicos: los nodos /{ig-user-id}, /{ig-comment-id} y /{ig-media-id} ahora devolverán todos los campos públicos cuando se acceda a ellos a través de un perímetro usando la expansión del campo. Consulta el documento de referencia de cada nodo para saber qué campos son públicos.

8 de febrero de 2018

  • API de publicación de contenido: los socios de la versión beta pueden incluir ahora hashtags al publicar fotos a través del perímetro /{ig-user-id}/media. ¡#crazywildebeest FTW!