Pular para o conteúdo principal
POST
Obtenha análises em tempo real, como curtidas, impressões, visualizações e reações de uma publicação enviada via Ayrshare usando o Ayrshare Post ID. Para análises em publicações originadas fora do Ayrshare, consulte Análises por Social Post ID.
Facebook: algumas métricas de alcance e vídeo foram descontinuadas pela Meta (15 de junho de 2026). A Meta removeu as métricas de Insights de impressões únicas e visualizações de vídeo de 3 segundos em todas as versões da Graph API, portanto o objeto analytics do Facebook não retorna mais impressionsUnique, impressionsFanUnique, impressionsOrganicUnique, impressionsPaidUnique ou videoViewsUnique. Use mediaView para alcance (um sucessor Total Unique Media Views está planejado). Outros campos comumente usados, como reactionsByType e videoViews, não são afetados. Referência: Próximas mudanças na API — 15 de junho de 2026.

Informações adicionais

  • As seguintes plataformas são atualmente suportadas: Bluesky, Facebook Pages, Instagram, X/Twitter, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok e YouTube.
  • As contagens de comentários do Facebook e Instagram mostradas na API podem diferir das contagens exibidas nos apps sociais. Isso ocorre por duas razões: - Alguns usuários têm configurações de privacidade que ocultam seus comentários de não-amigos ou usuários sem conexões mútuas. Esses comentários privados ainda são incluídos na contagem total de comentários. - Pode haver inconsistências nos dados relatados pela Meta.
  • Os valores de igReelsAggregatedAllPlaysCount e playsCount do Instagram mostrados na API podem diferir das contagens exibidas nos apps sociais. Isso pode ocorrer por alguns motivos:
    • A publicação foi promovida. Apenas reproduções orgânicas são incluídas na resposta da API.
    • Pode haver inconsistências nos dados relatados pela Meta.
  • Threads do X/Twitter retornam como um Array de objetos, com cada objeto correspondendo a um Tweet do Thread.
  • O YouTube pode levar de 24 a 48 horas para processar análises de vídeos com poucas visualizações ou seguidores do canal.
  • Análises do TikTok:
    • O TikTok pode levar de 24 a 48 horas para atualizar seus dados analíticos, como visualizações de vídeo, dados demográficos, curtidas, compartilhamentos e comentários.
    • Para acessar as análises do TikTok, os donos das contas devem: 1. Publicar pelo menos um vídeo. 2. Tocar no botão “Turn On” na página de Analytics do app móvel do TikTok. 3. Ter 100 seguidores para receber insights adicionais sobre espectadores e engajamento com o conteúdo.
    • O TikTok não retorna análises de publicação se a mídia contiver material com direitos autorais ou tiver sido sinalizada por violação de direitos autorais. Exemplos de material com direitos autorais podem incluir áudio em reels (o TikTok silenciará esses vídeos). Você pode verificar no app do TikTok em Activity -> System Notifications.
    • Alguns campos de análises do TikTok podem estar indisponíveis se o vídeo estiver inativo por mais de 7 dias. Para obter esses dados, gere uma nova atividade no vídeo (visualização, curtida, comentário ou compartilhamento) e tente novamente após 24-48 horas. Se um vídeo não for retornado na resposta, o motivo provável é que ele foi filtrado devido a violações, como violação de direitos autorais de música. Esses campos incluem:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • Perfis pessoais (de membro) do LinkedIn agora retornam uma matriz expandida de análises de publicação. As métricas de membro disponíveis são:
    • impressionCount — Impressões na publicação
    • uniqueImpressionsCount — Membros únicos alcançados (LinkedIn MEMBERS_REACHED)
    • likeCount — Contagem de reações
    • commentCount — Contagem de comentários
    • shareCount — Recompartilhamentos da publicação
    • engagement — Cliques, curtidas, comentários e compartilhamentos orgânicos sobre impressões
    • reactions — Desdobramento de reações por tipo (quando há reações)
    • Para publicações em vídeo: videoViews, videoViewers e videoWatchTimeMs
    Métricas de vídeo são retornadas apenas para publicações em vídeo e ficam indisponíveis mais de um ano após a criação da publicação.
  • Insights de Stories do Instagram estão disponíveis apenas por 24 horas, independentemente de os stories estarem arquivados ou em destaques. Observação:
    • Métricas de mídia de Story com valores menores que 5 retornam como 0.
    • Para Stories criados por usuários na Europa e no Japão, a métrica replies retorna o valor 0.
  • Análises de Story do Facebook não estão disponíveis.
  • Dados analíticos do Pinterest (impressões, seguidores de usuário e cliques) ficam disponíveis após 24-72 horas.
  • Para YouTube Shorts, as visualizações retornam o número de vezes que um Short começa a ser reproduzido ou reproduzido novamente, sem requisito mínimo de tempo de visualização.

Parâmetros de cabeçalho

Parâmetros do corpo

id
string
obrigatório
Ayrshare Post ID retornado do endpoint /post. Este é o id de nível superior do Ayrshare retornado, não os social post ids em postIds.
platforms
array
Array de strings de plataformas para obter análises. Aceita um array de strings com os valores:
Se platforms não for incluído, as análises serão retornadas para todas as redes sociais para as quais a publicação foi enviada.
Quando métricas cumulativas (por exemplo, curtidas, comentários, visualizações) estão temporariamente indisponíveis na rede social, a API as preenche automaticamente a partir de dados armazenados. Dois campos opcionais podem aparecer no objeto analytics por plataforma:
  • backfilledFrom (string, ISO 8601) — Presente quando uma ou mais métricas cumulativas foram substituídas por dados armazenados. O timestamp indica quando os dados armazenados foram atualizados pela última vez.
  • recoveredFrom (string, ISO 8601) — Presente quando toda a resposta de análises foi recuperada de dados armazenados devido a uma falha completa da API. O timestamp indica quando os dados armazenados foram atualizados pela última vez.
Dados armazenados com mais de 4 dias são considerados desatualizados e não serão usados para backfill ou recovery.
Análises pessoais (de membro) do LinkedIn — revinculação obrigatória. Perfis pessoais do LinkedIn vinculados antes do lançamento das análises de publicação de membro não têm os scopes de análises necessários. Requisições de análises para esses perfis retornam o código de erro 475 (“re-link your LinkedIn profile to enable analytics”). O dono da conta deve revincular seu perfil do LinkedIn na página Social Accounts para conceder os novos scopes. Aguarde alguns minutos após a revinculação para que o code 475 deixe de aparecer (Ayrshare e LinkedIn armazenam brevemente o estado da permissão em cache, tipicamente ~5-10 minutos). A publicação não é afetada.As contagens de publicações de membro do LinkedIn são best-effort: os totais agregados de shareCount (RESHARE), likeCount (REACTION) e commentCount (COMMENT) podem diferir ligeiramente dos números mostrados na UI do LinkedIn.