Métricas
Impressões, alcance, visualizações, curtidas, comentários, compartilhamentos, salvamentos, cliques e taxa de engajamento de cada post, por rede; seguidores e médias por conta; e um resumo do espaço. Tudo requer o scope posts:read (chaves limitadas).
Um post
curl https://wyroapi.com/v1/posts/post_abc123/metrics -H "Authorization: Bearer $WYRO_API_KEY"
{
"post_id": "post_abc123",
"status": "published",
"simulated": false,
"totals": { "impressions": 15420, "reach": 12350, "views": 900, "likes": 342, "comments": 28, "shares": 45, "saves": 12, "clicks": 189, "engagement_rate": 2.76 },
"targets": [
{
"account_id": "acc_ig1",
"platform": "instagram",
"available": true,
"metrics": { "impressions": 15420, "reach": 12350, "views": 900, "likes": 342, "comments": 28, "shares": 45, "saves": 12, "clicks": null, "engagement_rate": 2.78 },
"published_url": "https://www.instagram.com/p/…",
"fetched_at": "2026-11-18T12:00:00.000Z"
},
{
"account_id": "acc_tt1",
"platform": "tiktok",
"available": false,
"reason": "syncing",
"reason_text": "…",
"metrics": null
}
],
"fetched_at": "2026-11-18T12:00:00.000Z",
"stale": false,
"next_refresh_at": "2026-11-18T13:00:00.000Z",
"next_step": "…"
}
- Uma entrada por conta de destino.
nullnuma métrica quer dizer que essa rede não informa (veja a tabela abaixo);0é um zero real. available: falsevem comreasone umreason_textno idioma do espaço:not_published(agendado ou ainda saindo),failed(a publicação falhou ali),syncing(a rede ainda não entregou: consulte de novo em alguns minutos),not_available(essa rede ou esse post não dá métricas),post_not_found(apagado na rede),temporarily_unavailable.engagement_rateé uma porcentagem: (likes + comments + shares + saves) / (impressions, senão reach, senão views) × 100.totalssoma as redes.GET /v1/posts/{id}(e a lista) também traz ummetricscompacto com os totais quando existem, lido só do cache.
Quão atualizadas
As redes atualizam as métricas cerca de uma vez por hora, então o wyro as guarda por 1 hora e responde dali (rápido, e sem gastar os limites das redes). Depois dessa hora, a próxima leitura consulta de novo. Um post nunca é consultado mais de uma vez a cada 15 minutos: ?refresh=true força uma nova leitura dentro da hora, com esse limite. fetched_at diz quando os números foram lidos, stale: true que têm mais de uma hora (não foi possível consultar a rede) e next_refresh_at quando pode acontecer a próxima leitura.
Uma conta
curl "https://wyroapi.com/v1/accounts/acc_abc123/metrics?since=2026-11-01&until=2026-11-30" -H "Authorization: Bearer $WYRO_API_KEY"
followers:current,changeechange_pctno período, eseries(um ponto por dia). As redes atualizam os seguidores uma vez por dia.posts: quantos saíram no período e quantos têm métricas;totalseaverages(por post) das métricas;best_post(o de mais interações).since/until: YYYY-MM-DD (o dia inteiro, horário de Buenos Aires) ou ISO 8601. Padrão: os últimos 30 dias; no máximo 366.
O espaço
GET https://wyroapi.com/v1/analytics/overview mantém todos os campos que já tinha e soma performance: posts publicados no período com métricas, totals, by_platform, os top_posts (5) e uma series diária (posts, impressions, reach, views, interactions).
O que cada rede informa
| Rede | impressions |
reach |
views |
likes |
comments |
shares |
saves |
clicks |
|---|---|---|---|---|---|---|---|---|
| sim | sim | sim | sim | sim | sim | sim | — | |
| sim | — | sim | sim | sim | sim | — | sim | |
| TikTok | — | — | sim | sim | sim | sim | — | — |
| sim | sim | — | sim | sim | sim | sim | sim | |
| X | sim | — | sim | sim | sim | sim | sim | sim |
| Threads | — | — | sim | sim | sim | sim | — | — |
| YouTube | — | — | sim | sim | sim | — | — | — |
| sim | — | — | — | — | — | sim | sim |
O LinkedIn informa cliques em páginas de empresa e salvamentos em perfis pessoais. Os stories do Facebook não têm cliques.
Modo de teste
Com uma chave de teste (ou em contas simuladas) as métricas são simuladas: números realistas que dependem do id do post (o mesmo post sempre dá os mesmos números) e crescem durante o primeiro ou segundo dia, com simulated: true. Nada é lido de nenhuma rede. Mostre como exemplo, nunca como resultados reais.
Parceiros
Um parceiro atuando por um cliente (token de parceiro + X-Wyro-External-Id) lê as métricas desse cliente, e só as dele.
Pelo agente (MCP)
wyro_metricas: sem argumentos, o último post publicado («como foi meu último post?»); com post_id, esse post; com cuenta (id da conta ou rede), o resumo da conta (desde / hasta para o período). Responde no idioma do usuário.
No painel
O detalhe de cada post mostra as métricas por rede e quando foram atualizadas; o Início tem um bloco Desempenho do mês (interações, impressões e visualizações, taxa de engajamento, melhor post), e Contas mostra os seguidores de cada conta.