Insights de Reels do Instagram pela API
O endpoint de insights de mí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 em um Reel com crosspost. plays, clips_replays_count e ig_reels_aggregated_all_plays_count foram descontinuadas em abril de 2025, sendo substituídas por views.
O get_social_insights do easyCoexistence recebe o media ID de um Reel e os nomes das métricas, chama o endpoint de insights da Meta como a conta do Instagram conectada e devolve os números da Meta ou o erro da própria Meta.
Janela que reels_skip_rate mede: a fração das views que pulou o Reel 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 mídia.
Quanto tempo os dados por trás das métricas de mídia podem atrasar.
Por quanto tempo a Meta armazena as métricas de mídia.
Quais métricas um Reel retorna?
Aquelas que a referência de insights de mí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 rotula algumas delas como estimadas ou em desenvolvimento, indicado ao lado de cada uma, e conta curtidas e comentários apenas como atividade orgânica:
O que uma requisição de insights de Reels retorna?
Um objeto por métrica em data, cada um com name, period, values, title, description e id. period sempre traz lifetime: a Meta o define para métricas de mídia e não pode ser alterado, então a requisição não precisa dele. A referência da Meta descreve as duas métricas de tempo de exibição como quantidades de tempo sem informar uma unidade, então confira-as com um Reel que você conhece antes de fazer gráficos com elas.
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"
}
]
}Quais 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 em 21 de abril de 2025; video_views foi descontinuada a partir da v21.0 e em todas as versões em 8 de janeiro de 2025. Uma requisição que cita uma métrica descontinuada falha, então uma lista de métricas escrita antes de 2025 precisa 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 views e reach contam em um Reel?
views é o número de vezes que o Reel foi reproduzido no Instagram, métrica que a Meta rotula como em desenvolvimento; reach é o número de contas únicas que o viram ao menos uma vez, que a Meta rotula como estimada. likes, comments, views e total_interactions contam apenas atividade orgânica, deixando de fora o engajamento em anúncios feitos a partir do Reel. total_likes, total_comments e total_views, que incluem mídia promovida, são oferecidas somente com o Facebook Login.
Quais limites e atrasos se aplicam?
A referência de insights de mídia da Meta define estas regras para os números de um Reel:
- Os dados por trás das métricas podem atrasar em até 48 horas.
- As métricas de mídia são armazenadas por até 2 anos.
- Dados ausentes ou indisponíveis retornam um conjunto de dados vazio, não 0.
crossposted_viewsefacebook_viewsgeram erro para um Reel que não teve crosspost, então solicite-as em uma chamada própria.- Um detalhamento que uma métrica solicitada não suporta faz toda a requisição falhar com a mensagem An unknown error has occurred.
- Com o Instagram Login, o token precisa de
instagram_business_basiceinstagram_business_manage_insights, em graph.instagram.com.
Como get_social_insights lê um Reel?
Com o account_id da conexão, o ID de mí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, repassa os nomes das métricas à Meta como foram informados e devolve os dados da Meta, ou o erro próprio da Meta quando um nome está descontinuado. list_social_posts retorna os IDs de mí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 em 21 de abril de 2025; peça views.
- Misturar crossposted_views ou facebook_views em uma requisição geral. Elas geram erro para um Reel que não teve crosspost, e o erro faz a chamada falhar.
- Presumir uma unidade para o tempo de exibição. A referência da Meta não informa nenhuma para ig_reels_avg_watch_time nem para ig_reels_video_view_total_time, então confira com um Reel conhecido.
- Ler um resultado vazio como zero. A Meta retorna um conjunto de dados vazio quando os dados não existem ou estão indisponíveis no momento.
O easyCoexistence lê os insights de um Reel com get_social_insights, então Claude, ChatGPT ou o seu próprio código podem perguntar como um Reel foi e receber views, reach, tempo de exibição e taxa de pulo direto da Meta para a conta conectada, com o erro próprio da Meta quando um nome de métrica foi descontinuado. De US$ 9 a US$ 0.75 por conexão por mês, com redução conforme você adiciona conexões, e os primeiros 3 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
Por que uma requisição de insights de Reels retorna um resultado vazio?
A Meta retorna um conjunto de dados vazio, não 0, quando os dados não existem ou estão indisponíveis no momento, e os dados por trás das métricas podem atrasar em até 48 horas.
Como obtenho o tempo de exibição de Reels pela API?
Solicite ig_reels_avg_watch_time para a média e ig_reels_video_view_total_time para o total, incluindo as reproduções repetidas, em GET /<IG_MEDIA_ID>/insights.
O que é reels_skip_rate?
A porcentagem das views iniciais que pularam o Reel nos primeiros 3 segundos. A Meta a adicionou em 3 de dezembro de 2025 e a rotula 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 mídia promovida, é oferecida somente com o Facebook Login.
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