Plataforma de Instagram

Registro de cambios de la plataforma de Instagram

Este registro de cambios hace referencia a los cambios realizados en las API de Instagram.

Registros de cambios relacionados

3 de octubre de 2024

Los procesos de mensajes de bienvenida ya están disponibles para la API de Instagram con el inicio de sesión con Instagram. Más información.

2 de octubre de 2024

Media Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The video media metric video_views will no longer be supported.

The following endpoints and metrics are affected:

User Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The email_contacts, get_direction_clicks, profile_views, text_message_clicks, website_clicks, and phone_call_clicks time series metrics will no longer be supported.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • email_contacts
    • get_direction_clicks
    • profile_views
    • text_message_clicks
    • website_clicks
    • phone_call_clicks

17 de septiembre de 2024

Nuevos valores de scope

Se aplica a todas las versiones.

Para asegurar que se mantiene la coherencia entre los valores de scope y los nombres de los permisos, hemos incorporado nuevos valores de scope para la API de Instagram con el inicio de sesión con Instagram. Los nuevos valores de scope son los siguientes:

  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

Estos valores sustituirán los valores business_basic, business_content_publish, business_manage_comments y business_manage_messages existentes, respectivamente.

Ten en cuenta que los valores antiguos de scope quedarán obsoletos el 27 de enero de 2025. Es esencial que actualices el código antes de dicha fecha para evitar cualquier interrupción en la funcionalidad de la aplicación. De no hacerlo, la aplicación no podrá realizar llamadas a los extremos de Instagram.

Corrección: la fecha de retirada se ha cambiado del 17 de diciembre de 2024 al 27 de enero de 2025.

23 de julio de 2024

Lanzamiento de la nueva API de Instagram con el inicio de sesión de Instagram

Componentes de esta nueva API de Instagram:

  • Ya no se necesitará una página de Facebook.
  • La URL del host para las llamadas a la API es graph.instagram.com.
  • Nuevos permisos de esta API:
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • Ya no se usará la Messenger API para enviar mensajes de Instagram.
  • Las aplicaciones nuevas añadirán el nuevo producto de Instagram al crear una aplicación de Meta.
  • Las aplicaciones existentes pueden añadir el nuevo producto de Instagram en el panel de aplicaciones.

Consulta nuestra guía de migración para comprender si esta nueva API de Instagram con el inicio de sesión de Instagram es adecuada para ti.

11 de junio de 2024

Webhooks de comentarios de Instagram

Se aplica a todas las versiones.

Además de los valores de ad_id y ad_title, también se devolverá el valor de original_media_id en el objeto media del objeto value del campo comments cuando una persona comente en una publicación de Instagram o una publicación de anuncios de Instagram promocionadas. Para obtener más información, consulta Configurar webhooks para Instagram.

21 de mayo de 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:

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 los valores de ad_id y ad_title en el objeto media del objeto value del campo comments cuando una persona comente en una publicación de Instagram o una publicación de anuncios de Instagram promocionadas.

31 de octubre

Reels: etiquetas de producto

Se aplica a todas las versiones.

La API de etiquetado de productos de Instagram para Reels está disponible. Puedes etiquetar un máximo de 30 productos al publicar un reel.

28 de junio de 2022

Reels

Se aplica a todas las versiones.

Ahora se admiten los reels. Para publicar un vídeo como un reel, establece el parámetro media_type en REELS cuando crees el contenedor de una publicación con un único archivo multimedia. Consulta la referencia POST /ig-user/media endpoint para ver los parámetros que se pueden usar con los reels y los requisitos de los vídeos de reels.

27 de junio de 2022

Documentación de la API heredada de Instagram

Se aplica a todas las versiones.

Se ha eliminado la documentación para desarrolladores de la API heredada de Instagram y ahora redirige 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 productos de compras en Instagram en el contenido multimedia publicado de una cuenta empresarial de Instagram. Consulta la guía Etiquetado de productos para obtener más información al respecto.

27 de mayo de 2022

Variantes de productos

Se aplica a todas las versiones.

Para los socios de la versión beta del etiquetado de productos, ahora todas las variantes de productos que coincidan con los criterios de búsqueda de una consulta se devolverán al buscar 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 realizar publicaciones que contengan varios vídeos e imágenes (publicaciones por secuencia). En la guía Publicación de contenido, puedes consultar todos los pasos necesarios para realizar la publicación.

Si ya se han aprobado los permisos de tu aplicación que se necesitan para la publicación de contenido, no es necesario volver a someterla a la revisión de la aplicación para aprovechar esta funcionalidad.

9 de noviembre de 2021

Vídeos en directo

Se aplica a todas las versiones.

Ahora puedes utilizar la API de Instagram para obtener el contenido multimedia de Instagram de vídeo en directo que transmiten los usuarios de tu aplicación, obtener comentarios sobre dichos vídeos y utilizar la API de mensajes de Instagram para enviar respuestas privadas (mensajes directos) a los autores de los comentarios. Para admitir esta funcionalidad, se han llevado a cabo los cambios siguientes:

  • Un nuevo perímetro GET /ig-user/live_media puede devolver contenido multimedia de Instagram de vídeo en directo que el usuario de la aplicación está trasmitiendo en el momento de realizar la solicitud.
  • El campo media en un comentario de Instagram ahora devuelve un objeto que contiene el identificador (id) y la ubicación publicada (media_product_type) del contenido multimedia sobre el que se ha realizado el comentario.
  • Un nuevo campo live_comments de Webhooks de Instagram puede enviar notificaciones que contengan comentarios en directo realizados sobre los vídeos en directo de los usuarios de la aplicación mientras se transmiten.

Consulta la documentación de respuestas privadas de la API de mensajes de Instagram para obtener información sobre cómo enviar respuestas privadas a los usuarios que han comentado el contenido multimedia de vídeo en directo de los usuarios de la aplicación.

20 de octubre de 2021

Comentarios de Instagram

Se aplica a todas las versiones.

Se han añadido dos nuevos campos a los comentarios de Instagram:

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

Webhooks de Instagram

Se aplica a todas las versiones.

El campocomments de Webhooks de Instagram ahora incluye las siguientes propiedades en el objeto de campo value:

  • from.id: IGSID del usuario de Instagram que creó el comentario.
  • from.username: nombre del usuario de Instagram que creó el comentario.
  • media.id: identificador del contenido multimedia de Instagram en el que se realizó el comentario.
  • media.media_product_type: interfaz (ubicación publicada) del contenido multimedia de Instagram en el que se realizó el comentario.
  • parent_id: identificador del comentario principal de Instagram si el comentario se creó en otro comentario de Instagram (es decir, es una respuesta a otro comentario).

5 de octubre de 2021

Los siguientes cambios se aplican a los vídeos de Instagram TV creados a partir del 5 de octubre de 2021. Los vídeos de Instagram TV creados antes de esta fecha están exentos de estos cambios.

  • el campomedia_product_type devolverá FEED en lugar de IGTV.
  • el campovideo_title no se devolverá.
  • Ahora se admiten los campos comments y mentions de Webhooks de Instagram.

El 3 de enero de 2022, los cambios anteriores se aplicarán a todas las versiones de la API y a todos los vídeos de Instagram TV, independientemente de la fecha de creación del vídeo. Esto significa que, a partir del 3 de enero de 2022, las aplicaciones que utilicen versiones más antiguas de la API podrán enviar consultas a vídeos de Instagram TV (la compatibilidad de lectura se introdujo en la versión 10.0 y se limita a la versión 10.0 y las posteriores).

A partir de la versión 14.0, el campo video_title ya no se admitirá y la API devolverá un error si se solicita.

8 de junio de 2021

Recuentos de Me gusta

Se aplica a la versión 11.0 y las posteriores. Se aplicará a todas las versiones a partir del 7 de septiembre de 2021.

Si consultas un contenido multimedia de Instagram indirectamente a través de otro extremo o expansión de campo, el campo like_count se omitirá de las respuestas de la API si el propietario del contenido multimedia ha ocultado su recuento de Me gusta. Al consultar directamente el contenido multimedia de Instagram (solo puede hacerlo su propietario), se devolverá el recuento real de Me gusta, aunque se haya ocultado.


Paginación basada en el tiempo

Se aplica a la versión 11.0 y las posteriores.

Se añadieron los parámetros since y until al extremo GET /{ig-user-id}/media para admitir la paginación basada en el tiempo.

26 de mayo de 2021

Si consultas un contenido multimedia de Instagram indirectamente a través de otro extremo, ahora el campo like_count devolverá un valor igual a 0 si el usuario de la aplicación no es el propietario de dicho contenido y el propietario ha ocultado su recuento de Me gusta. El propietario del contenido multimedia de Instagram es el único que puede consultarlo directamente. Al hacerlo, se devolverá el recuento real de Me gusta, aunque el propietario haya ocultado este recuento para el contenido.

4 de mayo de 2021

Hicimos un pequeño cambio en la forma en que calculamos el resultado online_followers de los usuarios de IG.

14 de abril de 2021

Las interacciones con el contenido multimedia de las historias de Instagram que realizan los usuarios de Japón ya no se incluyen en algunos cálculos del resultado replies.

  • En el caso de las historias que creen los usuarios de Japón, el resultado replies ahora devolverá el valor 0.
  • En cuanto a las historias que creen los usuarios que no se encuentren en Japón, el resultado replies devolverá el número de respuestas, pero no se incluirán en el cálculo las respuestas de los usuarios que se encuentren en Japón.

12 de abril de 2021

Corregimos un pequeño error con las métricas de alcance en el contenido multimedia de IG de las historias.

9 de abril de 2021

16 de marzo de 2021

El contenido multimedia de IGTV ahora se admite en la versión 10.0 y posteriores. Se aplica a todos los extremos, excepto a aquellos que se utilizan para webhooks y la publicación de contenido. A fin de admitir este cambio, se han añadido los nuevos campos media_product_type y video_title al nodo de contenido multimedia de IG. El contenido multimedia de IGTV debe haberse compartido en Instagram en el momento de la publicación (las opciones Publicar una vista previa o Compartir vista previa en la sección de noticias deben estar habilitadas) a fin de que sea accesible a través de la API.

26 de enero de 2021

El programa beta de la publicación de contenido ha finalizado y todos los desarrolladores ahora pueden publicar contenido multimedia en las cuentas profesionales de Instagram. Consulta la guía Publicación de contenido para obtener detalles sobre el uso.

2 de diciembre de 2020

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

  • En el caso de las historias creadas por los usuarios del EEE, la métrica replies ahora devolverá el valor 0.
  • En cuanto a las historias que creen los usuarios fuera del EEE, el resultado replies devolverá el número de respuestas, aunque no se incluirán en el cálculo aquellas que realicen los usuarios en el EEE.

Este cambio se aplica a todas las versiones.

10 de noviembre de 2020

  • Insights de los usuarios de IG: ahora, los valores follower_count se alinean mejor con los valores correspondientes que se muestran en la aplicación de Instagram. Además, ahora, follower_count devuelve un máximo de 30 días de datos, en lugar de 2 años. Este cambio se aplica a partir de la versión 9.0 y se aplicará a todas las versiones el 9 de mayo de 2021.

5 de mayo de 2020

3 de diciembre de 2019

  • Insights: para ajustar el comportamiento de la API con el de la aplicación de Instagram, los insights sobre los usuarios de IG ahora solo están disponibles para los usuarios de IG que tienen 100 seguidores o más.

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 hashtags: ahora puedes buscar contenido multimedia etiquetado con hashtags específicos con nuestra nueva API de búsqueda de hashtags. #spooky!

23 de octubre de 2018

  • Perímetro /{ig-media-id}/comments: los resultados de las solicitudes GET realizadas con la versión 3.1 de la API o una anterior se devolverán por orden cronológico. En cambio, los resultados de las solicitudes realizadas con la versión 3.2 y posteriores se devolverán por orden cronológico inverso.

7 de junio de 2018

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

1 de mayo de 2018

  • Verificación del negocio: para poder utilizar la API Graph de Instagram, todas las aplicaciones deben someterse a la verificación del negocio, que forma parte del proceso de revisión de la aplicación y ahora se requiere para todos los extremos de la API Graph de Instagram. Todas las aplicaciones revisadas antes del 1 de mayo de 2018 se deben volver a revisar antes del 1 de agosto de 2018. De no hacerlo, perderán el acceso a la API.

24 de abril de 2018

  • Nodo /{ig-comment-id}:
    • Se añadió el nuevo campo username.
    • En el caso de las solicitudes GET, el campo user no se incluirá en las respuestas a menos que el comentario pertenezca al usuario que realiza la solicitud; en su lugar, devolveremos username para todos usuarios que realizaron comentarios. Esto también se aplica a las consultas de los comentarios realizados mediante otras API, como la API de menciones.
  • Nodo /{ig-media-id}:
    • Se añadió el nuevo campo username.
    • En el caso de las solicitudes GET, el campo owner no se incluirá en las respuestas a menos que el objeto multimedia pertenezca al usuario que realiza la solicitud; en su lugar, devolveremos username para todos usuarios que realizaron comentarios. Esto también se aplica a las consultas de los objetos multimedia realizadas mediante otras API, como la API de menciones.

23 de abril de 2018

  • API de insights: los insights ahora incluirán actividad publicitaria generada mediante la API, las interfaces de anuncios de Facebook y la función Promocionar de Instagram. Esto afecta a los resultados siguientes:

    • impressions
    • reach

13 de marzo de 2018

  • API de publicación de contenido: los socios con acceso a la versión beta ahora pueden utilizar 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 del nodo /{ig-media-id} ahora es 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 alguien acceda mediante un perímetro con la expansión de campos. Consulta el documento de referencia de cada nodo para ver los campos que son públicos.

8 de febrero de 2018

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