EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

3 seconds

Janela que reels_skip_rate mede: a fração das views que pulou o Reel 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 mídia.

48 hours

Quanto tempo os dados por trás das métricas de mídia podem atrasar.

2 years

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:

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 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.

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

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:

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 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_views e facebook_views geram 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_basic e instagram_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.

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 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.
Fazendo isso com o EasyCoexistence

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