Les premiers endpoints Threads de SocQ lisent les profils publics, les publications individuelles et les publications d’un utilisateur. Le 2026-11-17, cinq nouveaux endpoints ont été lancés. Deux d’entre eux concernent la recherche : trouver des publications par mot-clé ou hashtag, et trouver des comptes par nom. Les trois autres lisent les conversations et l’amplification : les réponses sous une publication, les réponses qu’un compte laisse ailleurs et les publications qu’il republie.
Ce guide présente ce que renvoie chaque nouvel endpoint, la requête, le prix et les cas où l’utiliser. Pour une comparaison avec l’API Threads de Meta et d’autres fournisseurs, consultez Alternatives à l’API Threads.
Réponse rapide : envoyez une
queryàPOST /v1/threads/searchou/search-users, ou des URL Threads dansurlsà/post-replies,/user-repliesou/user-reposts, avecAuthorization: Bearer $SOCQ_API_KEY. InterrogezGET /v1/tasks/{task_id}jusqu’à ce questatusvaillesucceeded, puis lisezdata.results.items. Les prix vont de 0,3 à 0,6 crédit par résultat ($0,0015 à $0,003 à $0,005 le crédit), sans frais de base.
Les cinq nouveaux endpoints Threads
| Endpoint | Ce qu’il renvoie | Entrée | Prix |
|---|---|---|---|
| Search | Meilleures publications pour un mot-clé ou un hashtag, environ 20, avec texte, auteur, mentions J’aime, réponses, republications, médias et date | query | 0,6 crédit ($0,003) par publication |
| User Search | Comptes correspondant à un nom ou un nom d’utilisateur, généralement jusqu’à 10, avec nom affiché, avatar et vérification | query | 0,6 crédit ($0,003) par compte |
| Post Replies | Réponses sous une publication, environ 20 par publication, avec auteur, mentions J’aime, réponses, médias et date | URL de publications | 0,3 crédit ($0,0015) par réponse |
| User Replies | Dernières réponses publiques d’un compte, jusqu’à environ 25, avec engagement et médias | URL de profils | 0,5 crédit ($0,0025) par réponse |
| User Reposts | Publications récemment republiées par un compte, jusqu’à environ 25, chacune avec son auteur d’origine | URL de profils | 0,5 crédit ($0,0025) par publication |
Rechercher sur Threads
Threads Search : publications par mot-clé ou hashtag
L’API Threads Search effectue une recherche sur Threads comme le fait l’application et renvoie les meilleures publications pour un mot-clé ou un hashtag. Chaque publication est fournie avec son texte, son auteur, ses mentions J’aime, ses réponses, ses republications, ses médias et sa date de publication. C’est le moyen le plus rapide de voir comment un sujet, un produit ou un événement est discuté sur Threads et d’identifier les comptes qui animent cette conversation.
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "basketball"
}'
Chaque recherche renvoie les meilleures publications que Threads affiche pour la requête, environ 20. L’engagement se trouve sous metrics : likes_count, comments_count et shares_count. Consultez la documentation Search.
Threads User Search : comptes par nom
L’API Threads User Search trouve des comptes par nom ou nom d’utilisateur. Chaque correspondance renvoie le nom d’utilisateur, le nom affiché, l’URL du profil, l’avatar et le statut de vérification. Utilisez-la pour confirmer le bon identifiant avant de récupérer publications ou réponses, ou pour transformer une liste de noms en profils Threads dans le cadre d’une recherche d’influenceurs.
curl -X POST "https://api.socq.ai/v1/threads/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "shams"
}'
Chaque recherche renvoie les comptes que Threads suggère, généralement jusqu’à 10. Consultez la documentation User Search.
Lire les conversations et les republications
Threads Post Replies : la conversation sous une publication
L’API Threads Post Replies lit la conversation sous une publication. Chaque réponse comprend son texte, son auteur, ses nombres de mentions J’aime et de réponses, les médias joints et sa date, ainsi que le post_id de la publication à laquelle elle répond. Utilisez-la pour mesurer la réaction à une annonce, recueillir les retours clients sous les publications d’une marque ou repérer les personnes les plus engagées dans l’audience d’un créateur.
curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]
}'
Utilisez des URL de publications au format /@{username}/post/{code}. Chaque publication renvoie les réponses que Threads affiche sous elle, environ 20. Consultez la documentation Post Replies.
Threads User Replies : comment un compte s’adresse aux autres
L’API Threads User Replies renvoie les dernières réponses publiques d’un compte avec texte, mentions J’aime, réponses, médias, date et un lien vers chaque réponse. Les réponses révèlent le ton et l’expertise plus directement que des publications soignées, ce qui les rend utiles pour évaluer des créateurs, surveiller un porte-parole ou étudier la façon dont une marque gère ses conversations avec les clients.
curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@reuters"]
}'
Utilisez des URL de profils telles que https://www.threads.com/@username. Chaque profil renvoie jusqu’à environ 25 réponses. Consultez la documentation User Replies.
Threads User Reposts : qui un compte amplifie
L’API Threads User Reposts renvoie les publications qu’un compte a choisi de republier. Chaque ligne correspond à la publication d’origine avec son auteur, son texte, son engagement et ses médias. L’historique des republications est un signal direct d’affinité : il cartographie les voix auxquelles un créateur fait confiance, les partenaires qu’une marque met en avant et les contenus qui circulent dans une communauté.
curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@shams"]
}'
Chaque profil renvoie jusqu’à environ 25 republications récentes ; author désigne l’auteur d’origine, pas le compte qui a republié. Consultez la documentation User Reposts.
Un workflow de recherche simple
- Lancez Search sur un nom de produit ou un hashtag pour trouver les publications qui suscitent de l’engagement.
- Transmettez les URL des publications les plus fortes à Post Replies pour lire les réactions.
- Utilisez User Search pour convertir les noms qui ressortent en identifiants, puis User Replies et User Reposts sur ces profils pour voir comment ils s’expriment et qui ils amplifient.
- Pour les publications d’un compte ou les détails de son profil, utilisez les endpoints existants User Posts et Profiles.
Authentification et flux de tâches asynchrones
Chaque requête transmet votre clé API et un type de contenu JSON :
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Chaque appel de soumission démarre une tâche en arrière-plan :
submit -> task_id -> queued -> running -> succeeded
\-> failed
La réponse de soumission renvoie data.task_id et data.status. Interrogez la tâche avec la même clé :
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Tant que la tâche est queued, running ou failed, la réponse ne contient que les métadonnées de la tâche ; en cas de failed, lisez error_message. Lorsqu’elle est succeeded, la même réponse inclut la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et monte jusqu’à 500. Si has_more vaut true, passez results.next_cursor comme cursor pour lire la page suivante. fields accepte jusqu’à 50 champs ou chemins pointés séparés par des virgules.
Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même task_id au lieu de soumettre à nouveau et de payer un doublon. Vous pouvez aussi ajouter callback_url au corps de la soumission pour recevoir un POST unique avec un résumé de la tâche lorsqu’elle se termine.
Combien coûte une tâche type
- Une recherche par mot-clé renvoyant 20 publications : 20 × 0,6 = 12 crédits, $0,06.
- Les réponses sous 10 publications, environ 20 chacune : 200 × 0,3 = 60 crédits, $0,30.
- Les réponses et republications de 10 comptes, environ 25 chacun : 500 × 0,5 = 250 crédits, $1,25.
FAQ
Puis-je aller au-delà des 20 premiers résultats de recherche ?
Search renvoie les meilleures publications que Threads affiche pour la requête, environ 20 par recherche. Pour élargir la couverture, lancez des mots-clés ou hashtags apparentés dans des recherches distinctes.
Ai-je besoin d’une connexion Threads ou Instagram ?
Non. Une requête ne contient que votre clé API SocQ et une requête de recherche ou des URL Threads publiques ; aucun identifiant de compte Threads n’en fait partie.
User Reposts indique-t-il qui a republié ?
Vous l’appelez pour un seul profil, donc chaque ligne a été republiée par ce profil. Le champ author de chaque ligne désigne l’auteur d’origine.
Puis-je envoyer plusieurs profils ou publications à la fois ?
Oui. Post Replies, User Replies et User Reposts acceptent une liste dans urls, et les nombres de résultats s’appliquent par URL.
Où voir tous les endpoints Threads et leurs prix ?
Sur la page de la plateforme Threads et la page des tarifs.
THREADS API
Tester le workflow avec une URL publique Threads
Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.
Découvrir les API Threads