Skip to main content
GET
Obtenha os comentários de uma publicação usando o Ayrshare Post ID, Social Post ID, Ayrshare Comment ID ou Social Comment ID com a Comment API. Consulte a visão geral de Comments para mais informações sobre os diferentes tipos de ID.
Se estiver usando o Ayrshare Post ID, nenhum parâmetro de query é necessário.

​
Detalhes adicionais sobre comentários

  • Os dados de comentários são atualizados a cada 10 minutos para todas as plataformas, com exceção do X. Devido a restrições impostas pela API do X, os dados de comentários do X são atualizados usando uma estratégia de exponential backoff, o que significa que os intervalos entre as atualizações aumentam gradualmente ao longo do tempo.
  • No X, solicitar comentários de uma publicação que é ela própria uma resposta retorna as respostas a essa publicação. Uma publicação do X que inicia sua própria conversa não muda e continua retornando as respostas de toda essa conversa.
  • Na resposta do Facebook, respostas a respostas de comentários sempre têm o mesmo parent.id.
  • Obtenha respostas a comentários do LinkedIn definindo os parâmetros de query "commentId": true e "searchPlatformId": true e fornecendo o Social Comment ID no parâmetro de caminho.
  • Facebook e Instagram retornam até os 1.000 comentários mais recentes de uma publicação. Entre em contato conosco para limites maiores no plano Enterprise.
  • Para uma publicação do TikTok que ainda está sendo processada (seu id é "pending"), get-comments retorna um erro claro de “ainda em processamento” (code: 288, HTTP 400) em vez de uma falha genérica. Tente novamente após o disparo do webhook tikTokPublished ou quando /history mostrar o video id resolvido.

​
Leituras Multiplataforma & Sucesso Parcial

Quando você solicita comentários com o Ayrshare Post ID, a publicação pode abranger várias plataformas. O Ayrshare distribui uma requisição (“etapa”) por plataforma e retorna um sucesso parcial se algumas etapas são bem-sucedidas e outras falham — os dados de comentários das plataformas saudáveis são sempre retornados, e cada etapa que falhou é enumerada em um array errors[] de nível superior.
  • Algumas plataformas com sucesso, outras com falha: a resposta é HTTP 200 com status: “partial”. Os blocos das plataformas saudáveis são retornados normalmente, e um array errors[] de nível superior lista cada etapa que falhou com seu platform, status, code, message e id.
  • Todas as plataformas falham: a resposta tem status: “error” e o array errors[] completo. O status HTTP é mapeado a partir do código de erro representativo de nível superior. O código 485 mapeia para HTTP 404; outros códigos representativos usam seus próprios mapeamentos.
  • Todas as plataformas com sucesso: a resposta permanece inalterada — HTTP 200, status: “success” e sem a chave errors[].
Mudança de comportamento — inspecione errors[], não ramifique pelo status HTTP. Como uma leitura multiplataforma com uma etapa que falha agora retorna HTTP 200 em vez de colapsar a resposta inteira em erro, os integradores devem sempre verificar a presença de um array errors[] de nível superior para detectar falhas por plataforma, em vez de confiar apenas no status code HTTP.

​
Comentários de Story do Instagram / Facebook Expirados ou Indisponíveis

Uma etapa de comentários de Story do Instagram ou do Facebook que esteja expirada ou indisponível — de modo que seus comentários não possam ser obtidos — aparece em errors[] com o código 485. Uma mensagem representativa do Instagram é “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” Se outra plataforma tiver sucesso, seus comentários ainda são retornados e a resposta geral é HTTP 200. Para uma resposta em que todas as etapas falham, o código representativo 485 mapeia para HTTP 404; outros códigos representativos usam seus próprios mapeamentos. Faça match pelo code (485), não pelo texto exato da mensagem.

​
Exemplo: Resposta de Sucesso Parcial

200: Sucesso Parcial

​
Falhas de cobrança e de rate limit do X

Uma leitura de comentários do X pode falhar na sua própria conta de desenvolvedor do X, na maioria das vezes porque ela não tem mais créditos de API ou porque você atingiu o rate limit do X. Essas falhas retornam um erro tipado em vez de uma lista de comentários vazia, para que um problema na conta nunca seja confundido com uma publicação sem comentários.
  • O X retorna HTTP 402 (sem créditos de API): o Ayrshare retorna code: 416 com HTTP 402.
  • O X retorna HTTP 429 (rate limit): o Ayrshare retorna code: 364 com HTTP 429. Quando o 429 do X indica que a conta está sem créditos, o Ayrshare retorna code: 416, porque esperar não resolverá o problema.
  • Falhas de autorização retornam code: 272, e qualquer outra falha do X retorna code: 219, ambas com HTTP 400.
Em uma leitura multiplataforma, a resposta tem status: “partial” no nível superior e a etapa do X que falhou aparece em errors[] com status: “error”, exatamente como descrito acima; uma leitura de plataforma única retorna o erro no nível superior. Quando o X rejeita a requisição diretamente, a falha não é armazenada em cache, então a leitura é tentada novamente assim que você solicitar os comentários outra vez. Uma publicação do X que foi excluída, ou que suas credenciais do X não conseguem ver, continua retornando um array vazio sem erro.

​
Parâmetros de cabeçalho

​
Parâmetros de caminho

​
string
obrigatório
Ayrshare Post ID, Social Post ID ou Social Comment ID.

​
Parâmetros de query

​
boolean
padrão:false
Se estiver obtendo comentários de uma publicação publicada via Ayrshare e usando o Ayrshare Post ID, não inclua este campo - o padrão é false. Se estiver obtendo comentários usando o Social Post ID ou Social Comment ID, que é o ID gerado pelas redes sociais, defina como true.
​
boolean
padrão:false
Se estiver obtendo comentários usando o Social Comment ID, que é o ID de comentário gerado pelas redes sociais, defina como true.Se estiver obtendo comentário usando o Ayrshare Post ID ou Social Post ID, não inclua este campo - o padrão é false.
Se usar o parâmetro de query commentId, você também deve definir searchPlatformId como true.
​
string
Obrigatório se searchPlatformId ou commentId for true.Quando usar:
  • Se estiver usando o Social Post ID e o campo "searchPlatformId": true. Plataformas suportadas: bluesky, facebook, instagram, linkedin, threads, tiktok, twitter, youtube.
  • Se estiver usando o Social Comment ID e os campos "searchPlatformId": true e "commentId": true. Plataformas suportadas: facebook, instagram, linkedin.
  • Se estiver usando o Ayrshare Post ID, não inclua este campo - os comentários serão retornados de todas as plataformas onde a publicação original foi publicada.

​
Exemplos de requisição GET de comentários