Passer au contenu principal
Lisez les données publiques de Threads en JSON via l’API de tâches asynchrones. Envoyez taskType SOCIAL avec platform threads, et choisissez ce que vous lisez avec action. Une requête terminée coûte 0.5 crédit.

Requête

Soumettez la tâche, puis interrogez GET /v1/async/task/{id} ou recevez son webhook. Voir Tâches asynchrones.

Actions

username accepte un nom d’utilisateur ou l’URL d’un profil. postUrl accepte l’URL d’une publication, comme https://www.threads.com/@natgeo/post/Dfzi22JJSYp.

Paramètres

  • query : obligatoire pour search.
  • limit : facultatif. search et profile acceptent de 1 à 50, avec 10 par défaut. replies accepte de 1 à 500, avec 50 par défaut.

Exemple de réponse

Champs du résultat

  • Chaque réponse reprend platform et action. Les listes portent returnedCount.
  • Une publication a id, code, url, text, author, authorVerified, publishedAt, mediaType (text, image, video ou carousel), images, videoUrl, likeCount, replyCount, repostCount, quoteCount, shareCount et isReply. Une réponse ajoute replyTo, le nom d’utilisateur auquel elle répond.
  • search renvoie posts dans l’ordre où Threads les montre, jusqu’à 50 environ.
  • profile renvoie id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, threadCount et recentPosts, les 4 à 13 publications les plus récentes qu’affiche la page du profil.
  • post renvoie post. replies renvoie replies, une dizaine par publication. availableCount est le nombre de réponses de la publication, et partial: true signale une liste plus courte que ce nombre, par exemple quand l’auteur a masqué des réponses.
  • Un profil ou une publication qui n’existe pas ou n’est pas public termine la tâche avec PAGE_UNAVAILABLE. Seules les requêtes terminées sont facturées.

Voir aussi