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.

threads/posts
Publications0,5 crédit par résultat

threads/profiles
Profils0,6 crédit par résultat

threads/user-posts
Publications0,5 crédit par résultat

threads/post-replies
Commentaires0,3 crédit par résultat

threads/search
Recherche0,6 crédit par résultat

threads/search-users
Recherche0,6 crédit par résultat

threads/user-replies
Publications0,5 crédit par résultat

threads/user-reposts
Publications0,5 crédit par résultat
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é | SocQ | Threads API |
|---|---|---|
| Usage principal | Collecter des profils publics, des publications et les publications récentes d’un utilisateur | Créer des intégrations autorisées de publication, de réponses, de statistiques et de découverte |
| OAuth côté client | Clé API SocQ ; pas d’OAuth Threads côté client | Application Meta, autorisation de l’utilisateur Threads et jeton d’accès |
| Entrée de départ | URL de profil ou de publication Threads publique | Contexte de compte autorisé, ID Threads et paramètres de recherche pris en charge |
| Publier ou gérer des réponses | Non pris en charge | Pris en charge avec les autorisations Threads requises |
| Format de réponse | Enregistrements SocQ normalisés | Objets 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. Envoyer des URL publiques
Envoyez des URL de profils ou de publications à l’API correspondante et conservez le task_id renvoyé.
2. Suivre la tâche
Interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.
3. Récupérer les résultats
Lisez data.results.items et utilisez next_cursor tant que has_more vaut true.
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 trueCas 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.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
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.
Bluesky API
Récupérez des profils Bluesky publics, résolvez des URL de publications connues ou collectez une page de publications d’un compte, avec identité, contenu, médias, horodatages et champs d’engagement visibles normalisés.
Snapchat API
Récupérez un Spotlight Snapchat public connu sous forme d’enregistrement normalisé, avec les champs disponibles de créateur, de légende, de média, d’audio, de date, de durée et d’engagement.
Twitch API
Transformez un nom d’utilisateur Twitch public connu en profil normalisé, collectez son inventaire de vidéos publiques ou récupérez un clip avec sa vidéo téléchargeable pour l’étude des créateurs, l’enrichissement de catalogues, la comparaison et le suivi par instantanés.
Rednote API
Récupérez des profils et des notes publics, recherchez des notes ou des utilisateurs, collectez les commentaires et leurs réponses imbriquées, et capturez une page de recommandations de la page d’accueil.
Kwai API
Récupérez des profils Kwai publics, une page de publications d’un compte ou une publication connue, avec identité, contenu, médias, horodatages et engagement visible normalisés.
Truth Social API
Récupérez les détails d’un compte public, collectez une page source de publications d’un compte ou transformez l’URL d’une publication connue en enregistrements normalisés.