Saltar para o conteúdo principal
Leia dados públicos do Threads em JSON pela API de tarefas assíncronas. Envie taskType SOCIAL com platform threads e escolha o que ler com action. Cada requisição concluída custa 0.5 crédito.

Requisição

Envie a tarefa e depois consulte GET /v1/async/task/{id} ou receba o webhook. Veja Tarefas assíncronas.

Ações

username aceita um nome de usuário ou o URL de um perfil. postUrl aceita o URL de uma publicação, como https://www.threads.com/@natgeo/post/Dfzi22JJSYp.

Parâmetros

  • query: Obrigatório para search.
  • limit: Opcional. search e profile aceitam de 1 a 50, com padrão 10. replies aceita de 1 a 500, com padrão 50.

Exemplo de resposta

Campos do resultado

  • Toda resposta repete platform e action. As listas trazem returnedCount.
  • Uma publicação tem id, code, url, text, author, authorVerified, publishedAt, mediaType (text, image, video ou carousel), images, videoUrl, likeCount, replyCount, repostCount, quoteCount, shareCount e isReply. Uma resposta acrescenta replyTo, o nome de usuário a quem ela responde.
  • search retorna posts na ordem em que o Threads os mostra, até cerca de 50.
  • profile retorna id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, threadCount e recentPosts, as 4 a 13 publicações mais recentes que a página do perfil mostra.
  • post retorna post. replies retorna replies, cerca de 10 por publicação. availableCount é a contagem de respostas da publicação, e partial: true marca uma lista menor que essa contagem, como quando o autor ocultou respostas.
  • Um perfil ou publicação que não existe ou não é público encerra a tarefa com PAGE_UNAVAILABLE. Só as requisições concluídas são cobradas.

Relacionado