Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Insights de Reels do Instagram através da API

O endpoint de insights de multimédia do Instagram, GET /<IG_MEDIA_ID>/insights, devolve estas métricas de um Reel: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time e reels_skip_rate, além de crossposted_views e facebook_views num Reel com crosspost. plays, clips_replays_count e ig_reels_aggregated_all_plays_count foram descontinuadas em abril de 2025, passando views a ocupar o seu lugar.

O easyCoexistence lê os insights de um Reel com get_social_insights, para que o Claude, o ChatGPT ou o seu próprio código possam perguntar como correu um Reel e obter visualizações, alcance, tempo de visualização e taxa de saltos diretamente da Meta para a conta ligada, com o erro da própria Meta quando um nome de métrica está descontinuado.

3 seconds

Janela medida por reels_skip_rate: a proporção de visualizações em que o Reel foi saltado nos primeiros 3 segundos.

21 Apr 2025

Quando plays, clips_replays_count e ig_reels_aggregated_all_plays_count foram descontinuadas em todas as versões da API.

3 Dec 2025

Quando reels_skip_rate, reposts, crossposted_views e facebook_views foram adicionadas aos insights de multimédia.

48 hours

Atraso máximo que os dados por trás das métricas de multimédia podem ter.

2 years

Durante quanto tempo a Meta guarda as métricas de multimédia.

Que métricas devolve um Reel?

Aquelas que a referência de insights de multimédia da Meta lista para media_product_type REELS, lidas com GET /<IG_MEDIA_ID>/insights e um parâmetro de métricas separado por vírgulas. A Meta classifica várias delas como estimadas ou em desenvolvimento, como indicado ao lado de cada uma, e conta os gostos e comentários apenas como atividade orgânica:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

O que devolve um pedido de insights de Reels?

Um objeto por métrica em data, cada um com name, period, values, title, description e id. period tem sempre o valor lifetime: a Meta define-o para as métricas de multimédia e não pode ser alterado, por isso o pedido não o precisa. A referência da Meta descreve as duas métricas de tempo de visualização como quantidades de tempo sem indicar uma unidade, por isso confirme-as com um Reel que conheça antes de as representar em gráficos.

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

Que métricas de Reels foram descontinuadas e o que as substituiu?

A Meta descontinuou as três primeiras a partir da Graph API v22.0 em 21 de janeiro de 2025, dia em que introduziu views, e em todas as versões a 21 de abril de 2025. video_views foi descontinuada a partir da v21.0 e em todas as versões a 8 de janeiro de 2025. Um pedido que nomeie uma métrica descontinuada falha, por isso uma lista de métricas escrita antes de 2025 tem de ser atualizada:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

O que contam as visualizações e o alcance num Reel?

views é o número de vezes que o Reel foi reproduzido no Instagram, uma métrica que a Meta classifica como em desenvolvimento; reach é o número de contas únicas que o viram pelo menos uma vez, que a Meta classifica como estimado. likes, comments, views e total_interactions contam apenas atividade orgânica, deixando de fora as interações com anúncios feitos a partir do Reel. total_likes, total_comments e total_views, que incluem conteúdo promovido, estão disponíveis apenas com o Facebook Login.

Que limites e atrasos se aplicam?

As regras da referência de insights de multimédia da Meta para os números de um Reel são estas:

  • Os dados por trás das métricas podem atrasar até 48 horas.
  • As métricas de multimédia são guardadas durante até 2 anos.
  • Dados em falta ou indisponíveis devolvem um conjunto de dados vazio, e não 0.
  • crossposted_views e facebook_views geram erro num Reel que não teve crosspost, por isso peça-as numa chamada própria.
  • Uma decomposição que uma métrica pedida não suporta faz falhar o pedido inteiro com An unknown error has occurred.
  • Com o Instagram Login, o token precisa de instagram_business_basic e instagram_business_manage_insights, em graph.instagram.com.

Como é que get_social_insights lê um Reel?

Com o account_id da ligação, o ID de multimédia do Reel como object_id e uma lista de métricas. O easyCoexistence chama GET /<IG_MEDIA_ID>/insights em graph.instagram.com com o token da conta, passa os nomes das métricas à Meta tal como os recebe e devolve os dados da Meta, ou o erro da própria Meta quando um nome está descontinuado. list_social_posts devolve os IDs de multimédia das publicações e Reels recentes da conta.

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

Erros comuns

  • Pedir plays ou clips_replays_count. Ambas foram descontinuadas em todas as versões da API a 21 de abril de 2025; peça views.
  • Misturar crossposted_views ou facebook_views num pedido geral. Geram erro num Reel que não teve crosspost, e o erro faz falhar a chamada.
  • Assumir uma unidade para o tempo de visualização. A referência da Meta não indica nenhuma para ig_reels_avg_watch_time nem para ig_reels_video_view_total_time, por isso confirme com um Reel conhecido.
  • Ler um resultado vazio como zero. A Meta devolve um conjunto de dados vazio quando os dados não existem ou estão indisponíveis de momento.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0,75 por ligação por mês, que desce à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Porque é que um pedido de insights de Reels devolve um resultado vazio?

A Meta devolve um conjunto de dados vazio, e não 0, quando os dados não existem ou estão indisponíveis de momento, e os dados por trás das métricas podem atrasar até 48 horas.

Como obtenho o tempo de visualização dos Reels pela API?

Peça ig_reels_avg_watch_time para a média e ig_reels_video_view_total_time para o total, incluindo as repetições, a partir de GET /<IG_MEDIA_ID>/insights.

O que é reels_skip_rate?

A percentagem de visualizações iniciais em que o Reel foi saltado nos primeiros 3 segundos. A Meta adicionou-a a 3 de dezembro de 2025 e classifica-a como estimada e em desenvolvimento.

Os insights de Reels incluem visualizações de anúncios?

Não. likes, comments, views e total_interactions contam apenas atividade orgânica; total_views, que inclui conteúdo promovido, está disponível apenas com o Facebook Login.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

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

Verificado em