threads/
search-users

Trouvez des comptes Threads par nom ou nom d’utilisateur, avec les correspondances que Threads suggère, en général jusqu’à 10, accompagnées du nom d’utilisateur, du nom affiché, de l’URL du profil, de l’avatar et du statut vérifié.

Threads User Search API

Requête par nom ou pseudo
Jusqu’à 10 résultats environ
Statut vérifié
0,6 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 User Search

La recherche d’utilisateurs Threads correspond à la liste de comptes que l’application suggère pour un nom ou un pseudo saisi, chacun identifié par son nom d’utilisateur, son nom affiché, son lien de profil, son avatar et son badge de vérification. Ces identifiants permettent de distinguer une personne ou une marque réelle des comptes au nom proche et de transformer une simple liste de noms en profils Threads confirmés.

Fonctionnalités de la Threads User Search API

  • Correspondances sur les noms et les pseudosquery accepte un nom affiché ou un nom d’utilisateur, et la réponse contient les comptes que Threads suggère pour celui-ci, en général jusqu’à 10.
  • Des champs d’identité prêts à l’emploiChaque correspondance renvoie username, name et url, le lien de profil au format /@username que les autres endpoints Threads prennent en entrée.
  • Badge et avatar pour lever les ambiguïtésis_verified et avatar_url aident à choisir le véritable compte lorsque plusieurs correspondances portent le même nom.

Paramètres de la Threads User Search API

ParamètresObligatoireDescription
queryObligatoireLe nom d’une personne ou d’une marque, ou un nom d’utilisateur Threads, comme shams.

Comment utiliser la Threads User Search API

Recherchez un nom et lisez les comptes suggérés.

  1. Envoyez {"query": "shams"} en POST à /v1/threads/search-users.
  2. Interrogez GET /v1/tasks/{task_id} avec le task_id renvoyé jusqu’à ce que status vaille succeeded.
  3. Lisez les comptes correspondants dans results.items, en suivant results.next_cursor chaque fois que has_more vaut true.
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"}'

# 0.6 credits for each account returned.

Cas d’usage de la Threads User Search API

  • Confirmer un pseudo avant de collecter du contenu : Vérifiez username, le nom affiché et is_verified pour retenir la bonne correspondance, puis utilisez son url pour récupérer les publications, réponses ou republications du compte.
  • Transformer une liste de noms en profils Threads : Recherchez chaque nom d’une liste d’influenceurs ou de journalistes et gardez l’url de la correspondance vérifiée pour constituer une colonne de liens de profils Threads.
  • Repérer les comptes sosies : Recherchez une marque ou une personnalité publique et examinez les correspondances non vérifiées aux noms et avatars presque identiques, susceptibles d’être des usurpations ou des pages de fans.

Conseils d’expert pour la Threads User Search API

  • Essayez à la fois le nom complet et un pseudo probable lorsque le compte voulu n’apparaît pas dans les premières correspondances, puisque query porte sur l’un comme sur l’autre.
  • Choisissez une correspondance d’après username et is_verified plutôt que de prendre la première ligne, car les noms courants renvoient plusieurs comptes similaires.
  • Passez directement l’url retenue à Threads User Posts, User Replies ou User Reposts API, qui acceptent tous des liens de profil sous cette même forme.

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

  • Threads Posts API — Collectez le texte des publications publiques, le contexte de l’auteur, les médias, horodatages et l’engagement visible à partir d’URL de publications Threads prises en charge.
  • 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.

Explorer d’autres plateformes

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

Threads User Search API — FAQ

Threads User Search API est une interface programmatique qui trouve des comptes Threads à partir d’un nom ou d’un nom d’utilisateur. Elle renvoie les comptes suggérés par Threads, chacun avec son nom d’utilisateur, son nom affiché, son lien de profil, son avatar et son statut de vérification.

En général jusqu’à 10, soit les mêmes suggestions que Threads propose pour le nom ou le pseudo saisi.

Les résultats de recherche servent à identifier les comptes. Envoyez l’url de chaque correspondance à Threads Profiles API pour collecter sa bio, son site web et ses nombres d’abonnés visibles.

Chaque compte renvoyé coûte 0,6 crédit : une recherche avec 10 correspondances coûte donc 6 crédits.