EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Insights do Instagram pela API: métricas de conta e de posts

A API do Instagram retorna insights de uma conta profissional e de cada um dos seus posts, Reels e Stories. As métricas da conta incluem alcance, visualizações, contas engajadas, seguidores ganhos e perdidos, curtidas, comentários, salvamentos e compartilhamentos. As métricas de posts incluem alcance, visualizações, curtidas, comentários, salvamentos e compartilhamentos. A Meta avisa que os dados podem ter atraso de até 48 horas.

O easyCoexistence lê os insights do Instagram com get_social_insights, então você pode perguntar ao Claude ou ao ChatGPT como foram os posts da semana passada e receber alcance, visualizações, curtidas, comentários, salvamentos e compartilhamentos direto da Meta, da conta ou de um único post.

48 hours

Quanto tempo os dados das métricas do Instagram podem atrasar.

100 followers

Abaixo desse número, a conta não recebe seguidores ganhos e perdidos nem os dados demográficos de seguidores.

2 years

Por quanto tempo a Meta armazena as métricas de mídia.

24 hours

Por quanto tempo as métricas de Stories ficam disponíveis pela API.

21 Apr 2025

Quando a métrica impressions deixou de funcionar em todas as versões da API, exceto em mídias criadas antes de 2 de julho de 2024; views a substituiu.

Quais métricas da conta estão disponíveis?

São lidas com GET /<IG_ID>/insights, em geral com period=day e metric_type=total_value:

  • reach: contas únicas que viram o conteúdo, incluindo anúncios; valor estimado.
  • views: quantas vezes o conteúdo foi reproduzido ou exibido.
  • accounts_engaged: contas que interagiram com o conteúdo, incluindo anúncios; valor estimado.
  • follows_and_unfollows: seguidores ganhos e perdidos no período; exige pelo menos 100 seguidores.
  • likes, comments, saves, shares, replies e reposts, além de total_interactions.
  • profile_links_taps: toques nos botões de endereço comercial, ligação, e-mail e mensagem de texto.
  • follower_demographics e engaged_audience_demographics: idade, cidade, país e gênero.

Quais métricas de posts estão disponíveis?

São lidas com GET /<IG_MEDIA_ID>/insights; as métricas disponíveis dependem do formato. Em um post ou Reel, curtidas, comentários, visualizações e total de interações contam apenas a atividade orgânica, não o engajamento nos anúncios criados a partir dele.

  • Posts e Reels: reach, views, likes, comments, saved, shares, total_interactions e reposts.
  • Somente Reels: ig_reels_avg_watch_time, ig_reels_video_view_total_time e reels_skip_rate.
  • Posts e Stories: follows, profile_visits e profile_activity.
  • Stories: reach, views, shares, replies, navigation, reposts e total_interactions.

Como funcionam period, metric_type e os detalhamentos?

As métricas da conta usam period=day. metric_type=total_value retorna um único valor para o intervalo e é o que os detalhamentos exigem; time_series retorna um valor por dia e está disponível para reach. Os detalhamentos dividem um total por media_product_type (posts, carrosséis, Reels, Stories e anúncios), por follow_type (seguidores ou não) ou por contact_button_type.

As métricas demográficas usam um timeframe, como this_week ou this_month, em vez de since e until; sem since e until, as demais métricas consideram as últimas 24 horas. Pedir um detalhamento que uma das métricas solicitadas não aceita faz a requisição inteira falhar com um erro desconhecido.

Quais limites mínimos e atrasos se aplicam?

As regras da Meta sobre quando um número aparece e por quanto tempo ele fica disponível:

  • Os dados podem ter atraso de até 48 horas.
  • Contas com menos de 100 seguidores não recebem follows_and_unfollows nem follower_demographics; engaged_audience_demographics exige 100 engajamentos no timeframe.
  • Dados ausentes ou indisponíveis voltam como um conjunto vazio, não como 0.
  • As métricas demográficas retornam apenas os 45 principais valores.
  • As métricas da conta ficam armazenadas por até 90 dias; as métricas de mídia, por até 2 anos.

O que muda em Stories e carrosséis?

As métricas de Stories ficam disponíveis por apenas 24 horas, e um valor abaixo de 5 retorna o código de erro 10, not enough viewers, em vez de um número. Respostas de pessoas na Europa e no Japão ficam de fora, e um Story criado por uma conta dessas regiões informa 0 respostas. Com o Instagram Login não existe o webhook story_insights, então os números de Stories precisam ser lidos enquanto o Story está no ar.

Um carrossel conta como um único post: a Meta não retorna insights das fotos e dos vídeos dentro dele.

Por que os nomes das métricas mudam?

Porque a Meta aposenta e renomeia métricas entre versões da API. impressions foi descontinuada na v22.0 e deixou de funcionar em todas as versões em 21 de abril de 2025, exceto em mídias criadas antes de 2 de julho de 2024, e views entrou no lugar; plays, clips_replays_count e ig_reels_aggregated_all_plays_count saíram ao mesmo tempo. video_views e várias séries temporais de perfil, entre elas profile_views, foram removidas antes. Uma requisição com um nome aposentado falha, então uma lista de métricas escrita para uma versão anterior da API pode precisar de atualização.

Erros comuns

  • Pedir impressions. A métrica não funciona mais em nenhuma versão da API; peça views no lugar.
  • Tratar um resultado vazio como zero. A Meta retorna um conjunto de dados vazio quando uma métrica está indisponível, o que não é o mesmo que ausência de atividade.
  • Ler as métricas de um Story depois que ele termina. Elas ficam disponíveis por apenas 24 horas.
  • Adicionar um detalhamento a uma requisição de várias métricas. Se uma delas não o aceitar, a chamada inteira falha.
Fazendo isso com o EasyCoexistence

De R$ 29,90 a R$ 3,90 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

O que substituiu impressions na API do Instagram?

views, que conta quantas vezes o conteúdo foi reproduzido ou exibido. A Meta aposentou impressions em todas as versões da API em 21 de abril de 2025, exceto em mídias criadas antes de 2 de julho de 2024.

Por que minha conta não retorna dados de seguidores?

A Meta não retorna follows_and_unfollows nem dados demográficos de seguidores para contas com menos de 100 seguidores.

Até quanto tempo atrás posso consultar os insights do Instagram?

Até 90 dias de métricas da conta e até 2 anos de métricas de mídia, sendo que online_followers cobre apenas os últimos 30 dias.

Os números incluem anúncios?

Em parte. O alcance e as contas engajadas de uma conta incluem anúncios, enquanto curtidas, comentários e visualizações de um post contam apenas a atividade orgânica.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em