Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.
Actualización del documento en inglés: 1 may.

Insights

Puedes utilizar la API Graph de Instagram para obtener resultados de interacción social de los usuarios de Instagram y sus objetos de contenido multimedia de la plataforma. Las cifras de cada resultado se calculan cuando la API las solicita.

Debido a las reglas de privacidad, las interacciones con el contenido multimedia de Instagram de las historias relacionadas con los mensajes que realicen los usuarios en algunas regiones ya no se incluirán en algunos cálculos de resultados. Entre estas regiones se incluyen las siguientes: 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 los usuarios en las regiones afectadas, el resultado de replies ahora devolverá el valor 0.
  • En cuanto a las historias que creen los usuarios fuera de las regiones afectadas, el resultado replies devolverá el número de respuestas, aunque no se incluirán en el cálculo aquellas que realicen los usuarios en dichas regiones.

Limitaciones

  • Algunos resultados no estarán disponibles para los usuarios de Instagram con menos de 100 seguidores.
  • La API solo informa de las métricas de interacción orgánicas, de modo que las interacciones con anuncios que incluyen un objeto de contenido multimedia no se tienen en cuenta.
  • Los datos de las métricas de contenido multimedia se almacenan durante un máximo de dos años. Los datos de las métricas de usuario se almacenan durante un máximo de 90 días.
  • Solo puedes obtener insights para un usuario a la vez.
  • No puedes obtener insights de las páginas de Facebook.
  • Los insights de historias solo están disponibles durante 24 horas, aunque las historias se archiven o destaquen. Si quieres obtener los Insights más recientes de una historia antes de que caduque, configura un webhook para el tema Instagram y suscríbete al campo story_insights.
  • Los insights del contenido multimedia de Instagram dependiente del álbum no se admiten.
  • Si los datos de insights que solicitas no existen o no están disponibles actualmente, la API devolverá un conjunto de datos vacío en lugar de 0 para los resultados individuales.

UTC

Las marcas de tiempo de las respuestas de la API utilizan UTC con un desplazamiento igual a cero y tienen el formato ISO-8601. Por ejemplo: 2019-04-05T07:56:32+0000

Extremos

La API consta de los extremos siguientes:

Consulta en la documentación de referencia de cada extremo los requisitos de métricas, parámetros y permisos disponibles.

Ejemplos

Obtención de métricas de la cuenta

Para obtener las métricas de una cuenta empresarial o de creador de Instagram, consulta el perímetro GET /{ig-user-id}/insights y especifica las métricas que quieres que se devuelvan.

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

Obtención de métricas de contenido multimedia

Para obtener las métricas de un objeto de contenido multimedia, consulta el perímetro GET /{ig-media-id}/insights y especifica las métricas que quieres que se devuelvan.

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