threads/
posts

Collectez des publications Threads publiques à partir d’URL de publication prises en charge, avec texte, identité de l’auteur, médias, date de publication et engagement visible dans des enregistrements normalisés.

Threads Posts API

URL de publication en entrée
Contexte de l’auteur
Instantané d’engagement
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Threads Posts

Les publications Threads sont des contenus publics à dominante textuelle, avec l’identité de l’auteur, des références de médias, une date de publication et les nombres visibles de mentions, de commentaires, de reposts et de partages. Ces enregistrements servent à étudier des publications choisies, à vérifier les sources, à comparer des contenus et à analyser l’engagement avec horodatage.

Fonctionnalités de la Threads Posts API

  • Résolution directe par URL de publicationTransforme les URL publiques /@username/post/{post_id} de threads.com ou threads.net en enregistrements des publications exactement envoyées, et non d’un fil de profil.
  • Contenu de la publication et attribution à l’auteurRenvoie les identifiants de publication, les URL sources, le texte et, lorsqu’ils sont disponibles, l’ID, le nom d’utilisateur, le nom affiché et l’URL de profil de l’auteur, pour des enregistrements traçables.
  • Médias et instantané d’engagement visibleRéunit pour chaque publication les références de médias normalisées, les dates de publication et de collecte, ainsi que les nombres visibles de mentions, de commentaires, de reposts et de partages.

Paramètres de la Threads Posts API

ParamètresObligatoireDescription
urlsObligatoireListe obligatoire d’URL de publications Threads publiques sur threads.com ou threads.net, au chemin /@username/post/{post_id}.

Comment utiliser la Threads Posts API

Envoyez les publications Threads publiques que vous connaissez déjà, suivez la tâche asynchrone, puis lisez les résultats normalisés grâce à la pagination par curseur.

  1. Préparez une ou plusieurs URL de publications Threads publiques au chemin /@username/post/{post_id} sur threads.com ou threads.net.
  2. Envoyez les liens dans urls à /v1/threads/posts et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items, puis demandez le next_cursor renvoyé tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/threads/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example/post/POST_ID"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Threads Posts API

  • Enrichir une liste de publications choisies : Convertissez des URL de publications connues en enregistrements avec ID, texte, champs d’auteur, médias, horodatages et liens sources pour un jeu de données défini.
  • Relire le contenu public et son attribution : Appuyez-vous sur le texte, les références de médias, l’identité de l’auteur et l’URL d’origine pour examiner des publications choisies tout en gardant leur source publique.
  • Comparer des instantanés d’engagement : Associez likes_count, comments_count, reposts_count et shares_count à collected_at pour comparer des observations relevées à des moments différents.

Conseils d’expert pour la Threads Posts API

  • Validez chaque URL par rapport au chemin /@username/post/{post_id} avant l’envoi, pour que les pages de profil et les chemins Threads sans rapport ne fassent pas échouer la requête.
  • Dédoublonnez les liens envoyés d’après leur chemin de publication avant de constituer les lots, pour que des noms d’hôte pris en charge différents ne répètent pas le travail sur une même publication.
  • Réservez cet endpoint aux URL de publications connues ; omettez results_limit, car il ne découvre aucun fil de profil et ne développe pas une publication en réponses.
  • Gérez le texte, les champs d’auteur, les médias, la date de publication et chaque métrique comme facultatifs, pour qu’une publication publique partiellement exposée ne bloque pas le traitement des résultats.
  • Stockez collected_at avec les champs d’engagement visibles pour garder la trace du moment où chaque instantané a été observé.

En complément de la Threads Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Threads.

  • Threads Profiles API — Collectez l’identité publique d’un profil, ses biographies, images, sites web, nombres visibles et le contexte de collecte à partir d’URL de profils Threads prises en charge.
  • Threads User Posts API — Repérez les publications publiques à partir d’URL de profils Threads, avec limite par profil, contenu, auteurs, médias, horodatages, engagement visible et contexte source normalisés.
  • Threads Post Replies API — Collectez les réponses sous des publications Threads à partir de leurs URL, avec texte, auteurs, nombres de J’aime et de réponses, médias et ID de la publication commentée.
  • Threads Search API — Recherchez sur Threads par mot-clé ou hashtag les meilleures publications, avec texte, auteurs, J’aime, réponses, republications, médias et date de publication.
  • Threads User Replies API — Collectez les dernières réponses publiques publiées par un compte à partir d’URL de profils Threads, avec texte, engagement, médias et liens.
  • Threads User Reposts API — Collectez les publications qu’un compte a récemment republiées à partir d’URL de profils Threads, chacune sous la forme du post d’origine avec son auteur, son texte, son engagement et ses médias.

Explorer d’autres plateformes

Combinez les données Threads avec les données publiques d’autres plateformes sociales prises en charge.

Threads Posts API — FAQ

Threads Posts API transforme des URL de publications Threads publiques prises en charge en enregistrements normalisés avec texte, identité de l’auteur, médias, date de publication et nombres visibles de mentions, de commentaires, de reposts et de partages.

Envoyez une URL http ou https sur threads.com, www.threads.com, threads.net ou www.threads.net dont le chemin suit /@username/post/{post_id}. Les pages de profil et les autres formes de chemin sont rejetées.

Non. La charge utile de sélection de publications utilise urls sans results_limit, car chaque entrée désigne une publication publique précise et non un fil à limiter.

Non. Un enregistrement de publication peut inclure comments_count visible, mais il ne contient ni le texte des réponses, ni leurs auteurs, ni l’arbre des réponses.

Le texte, les informations sur l’auteur, les médias, la date de publication et chaque valeur d’engagement peuvent être vides quand l’enregistrement public de la source n’expose aucune valeur exploitable.

Chaque enregistrement de publication renvoyé coûte 0,5 crédit SocQ. Un ensemble de résultats vide n’entraîne aucun frais de résultat.