Insights

Com a Graph API do Instagram, é possível obter métricas de interação social de usuários e os objetos de mídia do Instagram relacionados. As quantias para cada métrica serão calculadas após a solicitação da API.

Limitações

• Algumas métricas não estão disponíveis para usuários do Instagram com menos de 100 seguidores.
• A API lista somente métricas de interação orgânica. Não serão contabilizadas as interações em anúncios com um objeto de mídia.
• Os dados de métricas de mídia são armazenados por até 2 anos. Os dados de métricas do usuário são armazenados por até 90 dias.
• Só é possível obter informações de um usuário por vez.
• Informações sobre Páginas do Facebook não poderão ser acessadas.
• As informações sobre Stories ficarão disponíveis por somente 24 horas, mesmo se os Stories em questão forem arquivados ou destacados. Se você quiser obter as informações mais recentes de um story antes que ele expire, será necessário configurar um Webhook para o tópico Instagram e assinar o campo story_insights.
• Não há compatibilidade com mídias subordinadas de álbum do Instagram.
• Se os dados de insights solicitados não existirem ou estiverem indisponíveis, a API retornará um conjunto de dados vazio para as métricas individuais, em vez de 0.

UTC

Os registros de data e hora das respostas da API usam o formato UTC com deslocamento zero e são formatados de acordo com a norma ISO-8601. Por exemplo: 2019-04-05T07:56:32+0000

Pontos de extremidade

A API consiste nos pontos de extremidade a seguir.

• GET /{ig-media-id}/insights, para obter métricas sobre um objeto de mídia.
• GET /{ig-user-id}/insights, para obter métricas sobre uma conta empresarial ou de criador de conteúdo do Instagram.

Consulte a documentação de cada ponto de extremidade para ver os requisitos de métricas, parâmetros e permissões disponíveis.

Exemplos

Como obter métricas sobre uma conta

Para obter métricas sobre uma conta comercial ou de criador de conteúdo do Instagram, consulte a borda GET /{ig-user-id}/insights e especifique as métricas que você quer receber.

Exemplo de solicitação

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

Exemplo de resposta

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

Como obter métricas sobre mídias

Para obter métricas sobre um objeto de mídia, consulte a borda GET /{ig-media-id}/insights e especifique as métricas que você quer receber.

Exemplo de solicitação

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

Exemplo de resposta

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