Insights de Story do Instagram pela API
O endpoint de insights de mídia do Instagram retorna estas métricas de um Story enquanto ele está no ar: alcance, visualizações, respostas, compartilhamentos, navigation, novos seguidores, profile_visits, profile_activity, republicações e total_interactions. navigation se desdobra por story_navigation_action_type em TAP_FORWARD, TAP_BACK, TAP_EXIT e SWIPE_FORWARD. As métricas de Story ficam disponíveis por 24 horas, valores abaixo de 5 retornam erro 10, e o Instagram Login não tem webhook story_insights.
O easyCoexistence lê os insights de um Story com get_social_insights enquanto ele está no ar, para que Claude, ChatGPT ou o seu próprio código possam perguntar como foram os Stories de hoje e receber alcance, visualizações, respostas, compartilhamentos e navegação direto da Meta para a conta conectada.
Por quanto tempo as métricas de mídia de Story ficam disponíveis pela API.
Valor retornado no lugar de um número quando uma métrica de Story é menor que 5: pouca gente viu a mídia para mostrar insights.
A única configuração que o guia de insights da Meta indica para o webhook story_insights; não é compatível com o Instagram Login.
O valor de replies de um Story criado por uma conta na Europa ou no Japão.
Quando a Meta incluiu link_clicks para Stories, contando toques em links como os adesivos de link, apenas para o Facebook Login.
Quais métricas um Story retorna?
As que a referência de insights de mídia da Meta lista para media_product_type STORY, lidas com GET /<STORY_MEDIA_ID>/insights enquanto o Story está no ar. Com o Instagram Login, a chamada vai para graph.instagram.com com um token que tenha instagram_business_basic e instagram_business_manage_insights, e period é sempre lifetime:
Como ler a navegação por ação?
Peça navigation sozinha com breakdown=story_navigation_action_type. O total vem em total_value.value e cada ação em total_value.breakdowns[].results, que somam esse total: TAP_FORWARD (Avançar), TAP_BACK (Voltar), TAP_EXIT (Saída) e SWIPE_FORWARD (Próximo Story). O exemplo de resposta da Meta escreve os valores em minúsculas:
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
?metric=navigation
&breakdown=story_navigation_action_type
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "navigation",
"period": "lifetime",
"values": [{ "value": 25 }],
"total_value": {
"value": 25,
"breakdowns": [
{
"dimension_keys": ["story_navigation_action_type"],
"results": [
{ "dimension_values": ["tap_forward"], "value": 19 },
{ "dimension_values": ["tap_back"], "value": 4 },
{ "dimension_values": ["tap_exit"], "value": 1 },
{ "dimension_values": ["swipe_forward"], "value": 1 }
]
}
]
},
"id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
}
]
}Por quanto tempo as métricas de Story ficam disponíveis?
24 horas. A Meta disponibiliza as métricas de mídia de Story por 24 horas apenas, a vida útil do próprio Story, embora os dados por trás delas possam demorar até 48 horas para chegar. Leia-as em intervalos enquanto o Story está no ar e guarde os últimos valores obtidos. A Meta observa que dados ainda podem chegar depois que o Story expira, se ele for adicionado a um destaque, e que chamadas da API, webhooks e o app podem então mostrar resultados diferentes.
Por que uma métrica de Story retorna erro 10?
Porque o valor é menor que 5. A Meta retorna o código de erro 10 com a mensagem (#10) Not enough viewers for the media to show insights no lugar de um número pequeno, então um Story visto por poucas pessoas pode falhar enquanto outro mais movimentado funciona. Trate isso como contagem baixa, não como falha geral, e não repita a chamada em loop.
Por que as respostas de um Story são 0?
Regras regionais. Respostas de pessoas na Europa, desde 1º de dezembro de 2020, e no Japão, desde 14 de abril de 2021, ficam fora da métrica replies, e um Story criado por uma conta em uma dessas regiões retorna 0. A referência da Meta define replies como IG Comments sobre o objeto de mídia do Story.
Existe um webhook story_insights?
Não com o Instagram Login. A tabela de campos da Meta marca story_insights como indisponível ali, a referência de insights de mídia diz que o webhook de insights não é compatível com o Instagram Login, e o guia de insights lista story_insights apenas para o Facebook Login. Com o Facebook Login, o campo dispara quando um Story expira, traz só as primeiras 24 horas de métricas e retorna contagens abaixo de 5 como -1.
Quais métricas de Story foram aposentadas ou limitadas?
Alguns nomes ainda aparecem em código antigo ou no changelog da Meta:
- impressions: descontinuada para mídias criadas após 2 de julho de 2024, então um Story atual informa visualizações.
taps_forward,taps_backe exits: aposentadas em 11 de dezembro de 2023; navigation, desdobrada porstory_navigation_action_type, informa as mesmas ações.link_clicks: toques em links como os adesivos de link, adicionada em 22 de junho de 2026 apenas para o Facebook Login.total_views: visualizações em todas as superfícies, incluindo mídia promovida, oferecida apenas com o Facebook Login.
Como o get_social_insights lê um Story?
Com o ID de mídia do Story como object_id, que o publish_instagram_post retorna como media_id quando publica o Story, e as métricas como uma lista. Peça navigation em uma chamada separada com params definido como breakdown story_navigation_action_type, pois um breakdown que uma métrica pedida não suporta faz a chamada inteira falhar. Os erros da Meta, incluindo o erro 10, chegam como a Meta os escreveu.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}Erros comuns
- Ler as métricas de um Story no dia seguinte. A Meta as disponibiliza por 24 horas apenas, então colete-as enquanto o Story está no ar.
- Repetir o erro 10 em loop. Ele significa valor abaixo de 5, pouca gente vendo, e não vai mudar até que mais pessoas vejam o Story.
- Pedir navigation com um breakdown junto de outras métricas. story_navigation_action_type funciona só com navigation, e um breakdown não suportado faz a chamada inteira falhar.
- Esperar pelo story_insights com o Instagram Login. A Meta não oferece esse webhook ali, então consulte o endpoint de insights antes que o Story expire.
Os Stories são publicados com publish_instagram_post. De US$ 9 a US$ 0.75 por número conectado ao mês, caindo conforme você adiciona números, com 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
Os insights de Story mudam depois que um Story é adicionado a um destaque?
Podem mudar. A Meta diz que um Story adicionado a um destaque pode continuar recebendo dados depois que expira, então a API, os webhooks e o app podem divergir por um tempo.
total_views funciona para Stories com o Instagram Login?
Não. total_views, que conta visualizações em todas as superfícies com mídia promovida incluída, é oferecida apenas com o Facebook Login; com o Instagram Login, peça views.
A API consegue ler os cliques em adesivos de link de um Story do Instagram?
Apenas com o Facebook Login. A Meta adicionou link_clicks para Stories em 22 de junho de 2026, contando toques em links como os adesivos de link, e não oferece isso com o Instagram Login.
O que substituiu taps_forward, taps_back e exits?
navigation, desdobrada por story_navigation_action_type em TAP_FORWARD, TAP_BACK, TAP_EXIT e SWIPE_FORWARD. As métricas antigas foram aposentadas em 11 de dezembro de 2023.
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