La API Graph de Instagram te permite obtener métricas de interacción social para usuarios de Instagram y sus objetos multimedia de Instagram. Las cantidades para cada métrica se calculan con una solicitud de API.
Debido a las reglas de privacidad, se dejarán de incluir en algunos cálculos de métricas las interacciones de contenido multimedia de IG en historias relacionadas con mensajes de los usuarios que se encuentren en determinadas regiones. Entre estas regiones se encuentran: Europa, a partir del 1.° de diciembre de 2020, y Japón, a partir del 14 de abril de 2021.
replies
devolverá un valor de 0
.replies
devolverá la cantidad de respuestas, pero el cálculo no incluirá las respuestas de los usuarios que se encuentran en dichas regiones.Instagram
y suscríbete al campo story_insights
.0
para las métricas individuales.Las marcas de tiempo en respuestas de API usan UTC sin desplazamiento y se les da formato conforme al estándar ISO-8601. Por ejemplo: 2019-04-05T07:56:32+0000
La API tiene los siguientes puntos de conexión:
GET /{ig-media-id}/insights
: permite obtener métricas de un objeto multimedia.GET /{ig-user-id}/insights
: permite obtener métricas de una cuenta de empresa o creador de Instagram.Consulta la documentación de referencia de cada punto de conexión para conocer los requisitos vinculados a métricas, parámetros y permisos disponibles.
Para obtener métricas de una cuenta de empresa o creador, haz una consulta al perímetro GET /{ig-user-id}/insights
y especifica las métricas que deseas recibir.
GET graph.facebook.com/17841405822304914/insights ?metric=impressions,reach,profile_views &period=day
{ "data": [ { "name": "impressions", "period": "day", "values": [ { "value": 32, "end_time": "2018-01-11T08:00:00+0000" }, { "value": 32, "end_time": "2018-01-12T08:00:00+0000" } ], "title": "Impressions", "description": "Total number of times the Business Account's media objects have been viewed", "id": "instagram_business_account_id/insights/impressions/day" }, { "name": "reach", "period": "day", "values": [ { "value": 12, "end_time": "2018-01-11T08:00:00+0000" }, { "value": 12, "end_time": "2018-01-12T08:00:00+0000" } ], "title": "Reach", "description": "Total number of times the Business Account's media objects have been uniquely viewed", "id": "instagram_business_account_id/insights/reach/day" }, { "name": "profile_views", "period": "day", "values": [ { "value": 15, "end_time": "2018-01-11T08:00:00+0000" }, { "value": 15, "end_time": "2018-01-12T08:00:00+0000" } ], "title": "Profile Views", "description": "Total number of users who have viewed the Business Account's profile within the specified period", "id": "instagram_business_account_id/insights/profile_views/day" } ] }
Para obtener métricas de un objeto multimedia, haz una consulta al perímetro GET /{ig-media-id}/insights
y especifica las métricas que deseas recibir.
GET graph.facebook.com/{media-id}/insights ?metric=engagement,impressions,reach
{ "data": [ { "name": "engagement", "period": "lifetime", "values": [ { "value": 8 } ], "title": "Engagement", "description": "Total number of likes and comments on the media object", "id": "media_id/insights/engagement/lifetime" }, { "name": "impressions", "period": "lifetime", "values": [ { "value": 13 } ], "title": "Impressions", "description": "Total number of times the media object has been seen", "id": "media_id/insights/impressions/lifetime" }, { "name": "reach", "period": "lifetime", "values": [ { "value": 13 } ], "title": "Reach", "description": "Total number of unique accounts that have seen the media object", "id": "media_id/insights/reach/lifetime" } ] }