Retour aux API
Données publiques Threads

Threads Public Data API

Récupérez des profils Threads publics, résolvez des publications connues ou collectez les publications de profils sélectionnés, avec des champs normalisés d’identité, de contenu, de médias, d’engagement et d’horodatage.

API Threads disponibles

Profiles pour les données de compte, Posts pour une publication publique connue, ou User Posts pour une collection bornée à partir de profils sélectionnés.

Quelles données Threads pouvez-vous récupérer ?

SocQ renvoie des enregistrements publics normalisés de comptes et de publications, avec le contexte d’identité, de contenu, de médias, d’engagement visible, de source et de date de collecte.

Détails des profils publics

Récupérez les ID de profil, les URL, les noms d’utilisateur, les noms affichés, les biographies, les images, les sites web liés, les nombres visibles du compte et la date de collecte.

Contenu d’une publication connue

Transformez l’URL d’une publication publique en identité de la publication, texte, informations sur l’auteur, URL de source et médias disponibles.

Engagement visible des publications

Conservez les dates de publication et de collecte avec les nombres disponibles de mentions « J’aime », de commentaires, de republications et de partages.

Publications de profils sélectionnés

Parcourez un ensemble borné de publications publiques pour chaque URL de profil, en gardant le profil envoyé rattaché aux résultats.

SocQ vs Threads API

SocQ se concentre sur la collecte prise en charge de données publiques Threads. L’API Threads de Meta est conçue pour la publication autorisée, les réponses, les statistiques et certains flux de découverte pris en charge.

FonctionnalitéSocQThreads API
Usage principalCollecter des profils publics, des publications et les publications récentes d’un utilisateurCréer des intégrations autorisées de publication, de réponses, de statistiques et de découverte
OAuth côté clientClé API SocQ ; pas d’OAuth Threads côté clientApplication Meta, autorisation de l’utilisateur Threads et jeton d’accès
Entrée de départURL de profil ou de publication Threads publiqueContexte de compte autorisé, ID Threads et paramètres de recherche pris en charge
Publier ou gérer des réponsesNon pris en chargePris en charge avec les autorisations Threads requises
Format de réponseEnregistrements SocQ normalisésObjets natifs de la Graph API de Threads

Fonctionnement de l’API Threads

Profiles, Posts et User Posts suivent le même flux : tâche asynchrone, puis résultats paginés.

  1. 1. Envoyer des URL publiques

    Envoyez des URL de profils ou de publications à l’API correspondante et conservez le task_id renvoyé.

  2. 2. Suivre la tâche

    Interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.

  3. 3. Récupérer les résultats

    Lisez data.results.items et utilisez next_cursor tant que has_more vaut true.

Collecter les publications d’un profil Threads

Authentifiez-vous avec votre clé API SocQ et envoyez l’URL d’un profil public à User Posts. Profiles et Posts suivent le même flux de tâche.

curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'

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

Cas d’usage courants de l’API Threads

Recherche sur les créateurs et les profils

Enrichissez des URL de profils connues avec l’identité publique, la biographie, le site web, les indicateurs visibles du compte et la date de collecte.

Analyse de publications connues

Transformez des URL de publications choisies en contenu, auteur, médias, date de publication, engagement visible et champs de source.

Suivi des contenus d’un créateur

Collectez un ensemble borné de publications de profils sélectionnés et comparez les contenus d’une collecte à l’autre.

Reporting d’engagement

Servez-vous des nombres visibles et de collected_at pour comparer des instantanés de publications publiques, sans les prendre pour des indicateurs en temps réel.

Limites et politique sur les données publiques

Les résultats Threads sont des enregistrements publics à un instant donné. Ces API n’accèdent pas aux contenus privés et ne publient, ne modifient, ne suppriment ni ne gèrent de comptes ou de publications Threads.

  • Profiles accepte les URL /@username de threads.com et de threads.net. Les noms d’utilisateur seuls et les URL de publication sont rejetés.
  • Posts accepte les URL /@username/post/{post_id}. Il ne prend en charge ni results_limit ni la découverte des publications d’un profil.
  • User Posts accepte les URL de profil /@username. results_limit vaut 100 par défaut, accepte de 1 à 2 000 et s’applique séparément à chaque profil.
  • User Posts n’indique pas si un résultat est une publication d’origine, une réponse, une citation ou une republication.
  • Une publication peut inclure comments_count, mais les réponses individuelles et les arbres de réponses ne sont pas renvoyés.
  • Les champs facultatifs d’identité, de contenu, de médias, d’horodatage et d’engagement peuvent être vides lorsque l’enregistrement public ne les expose pas.

Questions fréquentes sur l’API Threads

Qu’est-ce que l’API Threads ?

L’API Threads est un ensemble d’endpoints SocQ pour récupérer des données de profils publics, résoudre des publications connues et collecter un ensemble borné de publications de profils sélectionnés.

Quelle API Threads choisir ?

Utilisez Profiles pour les comptes /@username, Posts pour des liens /@username/post/{post_id} exacts, et User Posts pour une collection bornée à partir de chaque URL de profil /@username.

Comment fonctionne la limite de résultats de User Posts ?

results_limit vaut 100 par défaut, accepte les entiers de 1 à 2 000 et s’applique séparément à chaque URL de profil envoyée.

Les résultats de User Posts distinguent-ils les réponses ou les republications ?

Non, le résultat normalisé n’expose aucun sous-type de publication. Considérez chaque élément comme une publication publique découverte depuis le profil envoyé, sans en déduire s’il s’agit d’une publication d’origine, d’une réponse, d’une citation ou d’une republication.

Les publications Threads et les indicateurs d’engagement sont-ils complets ou en temps réel ?

Non. Les résultats reflètent les champs publics disponibles au moment de la collecte, n’incluent pas les arbres de réponses complets et doivent être considérés comme des instantanés, et non comme des flux en temps réel.

Comment la collecte Threads est-elle facturée ?

Chaque profil renvoyé coûte 0,6 crédit, tandis que chaque publication renvoyée par Posts ou User Posts coûte 0,5 crédit. Un jeu de résultats vide n’entraîne aucun frais de résultat.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.