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.
Janela medida por reels_skip_rate: a proporção de visualizações em que o Reel foi saltado nos primeiros 3 segundos.
Quando plays, clips_replays_count e ig_reels_aggregated_all_plays_count foram descontinuadas em todas as versões da API.
Quando reels_skip_rate, reposts, crossposted_views e facebook_views foram adicionadas aos insights de multimédia.
Atraso máximo que os dados por trás das métricas de multimédia podem ter.
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:
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.
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:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
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_viewsefacebook_viewsgeram 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_basiceinstagram_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.
{
"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.
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