Plataforma do Instagram

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.

Devido a regras de privacidade, as interações de mídia de story do Instagram relacionadas a mensagens e realizadas por usuários em determinadas regiões deixarão de ser incluídas em alguns cálculos de métricas. Isso inclui a Europa, a partir de 1º de dezembro de 2020, e o Japão, a partir de 14 de abril de 2021.

  • O retorno da métrica replies agora será 0 para os stories criados por usuários nas regiões afetadas.
  • Para os Stories criados fora desses locais, a métrica replies retornará o total de respostas. Entretanto, as respostas de usuários das regiões afetadas não serão incluídas no cálculo.

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.

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