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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste 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.
- Préparez une ou plusieurs URL de publications Threads publiques au chemin /@username/post/{post_id} sur threads.com ou threads.net.
- Envoyez les liens dans urls à /v1/threads/posts et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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 trueCas 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é.
API associées
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.