Se actualizó este documento.
La traducción en español no está disponible todavía.

Actualización del documento en inglés: 6 de may.

Estadísticas

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.

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

Limitaciones

Algunas métricas no están disponibles en los usuarios de IG con menos de 100 seguidores.
La API solo reporta métricas de interacción orgánica. Las interacciones en anuncios que contienen un objeto multimedia no se tienen en cuenta.
Los datos de métricas de estadísticas se almacenan por hasta 2 años. Los datos de métricas de usuarios se almacenan por hasta 90 días.
Solo se pueden obtener estadísticas de un usuario a la vez.
No se pueden obtener métricas de páginas de Facebook.
Las estadísticas de historias solo están disponibles durante 24 horas, aun cuando se archiven o se destaquen. Si deseas acceder a las últimas estadísticas de una historia antes de que caduque, configura un Webhook para el tema de Instagram y suscríbete al campo story_insights.
No son compatibles las estadísticas sobre el contenido multimedia de IG de los objetos secundarios del álbum.
Si los datos estadísticos que solicitas no existen o no se encuentran disponibles actualmente, la API devolverá un conjunto de datos vacíos en lugar de 0 para las métricas individuales.

UTC

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

Puntos de conexión

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.

Ejemplos

Obtener métricas de cuentas

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.

Ejemplo de solicitud

GET graph.facebook.com/17841405822304914/insights
    ?metric=impressions,reach,profile_views
    &period=day

Ejemplo de respuesta

{
  "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"
    }
  ]
}

Obtener métricas de contenido multimedia

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.

Ejemplo de solicitud

GET graph.facebook.com/{media-id}/insights
    ?metric=engagement,impressions,reach

Ejemplo de respuesta

{
  "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"
    }
  ]
}