Skip to main content
POST
/apis/analytics/social-by-id é esta página de documentação, não uma rota da API. Envie solicitações de uma publicação e em lote para POST /analytics/post, com exatamente um valor em platforms e searchPlatformId: true: {"id":"SOCIAL_POST_ID","platforms":["twitter"],"searchPlatformId":true} para uma publicação, ou {"postIds":["ID_1","ID_2"],"platforms":["twitter"],"searchPlatformId":true} para até 100 publicações.
Obtém análises para publicações que não foram originadas via Ayrshare fornecendo o Social Post ID de baixo nível. Esse ID é retornado no campo postIds do endpoint /post. A conta vinculada deve ser o proprietário da publicação para obter as análises (exceção: YouTube; veja abaixo). Plataformas suportadas: Facebook, Instagram, LinkedIn, Threads, TikTok, Twitter e YouTube.
  • A chamada é a mesma do endpoint Analytics on a Post. A principal diferença é que você usa o post id retornado pela rede social em vez do Ayrshare ID. Inclua também o parâmetro searchPlatformId: true para notificar o endpoint de que você está pesquisando pelo Social Post ID.
  • Use o endpoint Get All Post History para obter publicações e IDs originados fora do Ayrshare, encontrados no campo id.
  • Recomendado usar apenas para publicações não enviadas via Ayrshare. Para publicações enviadas via Ayrshare, use o endpoint de análises.
  • Análises em publicações do Instagram publicadas antes da conta do usuário ser convertida em conta business a partir de uma conta pessoal têm análises limitadas.
  • Ao obter análises do YouTube para uma publicação que não pertence ao seu canal usando o método de Social ID, a API retornará metadados descritivos sobre o conteúdo enquanto mostra zeros para todas as métricas numéricas. Informações descritivas como título, descrição, tags, título do canal, status de privacidade e URLs de thumbnail serão preenchidas corretamente, fornecendo contexto sobre o conteúdo do vídeo. No entanto, todas as métricas numéricas de desempenho, incluindo visualizações, curtidas, comentários, compartilhamentos, mudanças de inscritos, tempo de exibição e adições a playlists, retornarão como zero.
  • Ao usar postIds para threads do X/Twitter, o Social Post ID de cada tweet deve ser fornecido individualmente; tweets do thread não são incluídos automaticamente ao consultar a publicação pai.

​
Parâmetros de cabeçalho

​
Parâmetros do corpo

É necessário fornecer id ou postIds. Use id para uma única publicação ou postIds para obter análises de várias publicações em uma única requisição.
​
string
Social Post ID retornado do endpoint /post. Este é o campo id para uma rede social individual encontrado no array postIds. id ou postIds é obrigatório.
​
array
Array de Social Post IDs para obter análises de várias publicações em uma única requisição. Máximo de 100 IDs permitidos. id ou postIds é obrigatório.
​
array
obrigatório
Array de strings de plataformas para obter análises. Apenas um valor é permitido.Valores disponíveis:
​
boolean
padrão:false
obrigatório
Defina como true para pesquisar pelo Social Post ID.
Quando métricas cumulativas (por exemplo, curtidas, comentários, visualizações) estão temporariamente indisponíveis na rede social, a API automaticamente as preenche 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.
Uma resposta com code: 186 significa que o Social Post ID não foi encontrado para a conta e a plataforma selecionadas. A URL da mensagem retorna a esta página de documentação; ela não identifica outro endpoint da API. Corrija a solicitação e tente novamente POST /analytics/post usando um dos formatos acima.