x/
search-users

Recherchez des comptes d’utilisateurs X publics par mot-clé et obtenez identité, bio, statut de vérification et métriques d’audience normalisés.

Twitter User Search API

Recherche d’utilisateurs
Découverte de comptes
Profils normalisés
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

Twitter User Search

Repérer sur X les profils pertinents de créateurs, d’entreprises et d’experts suppose une recherche ciblée par mot-clé dans les identifiants et les bios des comptes. Les profils normalisés livrent noms d’utilisateur, noms affichés, bios, contexte de localisation, nombres d’abonnés et badges de vérification.

Fonctionnalités de la Twitter User Search API

  • Correspondance de comptes par mot-cléEnvoyez n’importe quel terme de recherche pour découvrir les profils publics pertinents parmi les noms, les noms d’utilisateur et les bios des comptes.
  • Attributs de profil normalisésRecevez des objets homogènes avec l’ID de l’utilisateur, l’identifiant, le nom affiché, l’avatar, la bannière et le texte de la biographie.
  • Métriques d’audienceRelevez les nombres actuels d’abonnés, d’abonnements, de posts au total, de médias et de favoris pour chaque compte renvoyé.
  • Indicateurs de vérification et de statutRepérez les badges bleus de vérification, les indicateurs de compte automatisé, le statut de compte protégé et les chaînes de localisation.

Paramètres de la Twitter User Search API

ParamètresObligatoireDescription
queryObligatoireMot-clé de recherche permettant de trouver les profils d’utilisateurs X publics correspondants.
results_limitFacultatifNombre maximal de profils d’utilisateurs à renvoyer ; doit être un multiple de 20 compris entre 20 et 2 000, avec 20 par défaut.

Comment utiliser la Twitter User Search API

Envoyez une recherche par mot-clé sous forme de tâche asynchrone, puis parcourez page par page les profils d’utilisateurs normalisés.

  1. Renseignez votre terme de recherche dans query et fixez results_limit à un multiple de 20 (jusqu’à 2 000).
  2. Envoyez une requête POST à /v1/x/search-users avec votre clé API SocQ.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut de la tâche soit succeeded.
  4. Récupérez les enregistrements de comptes normalisés dans data.results.items.
curl -X POST "https://api.socq.ai/v1/x/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"OpenAI","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Cas d’usage de la Twitter User Search API

  • Découverte d’influenceurs et d’experts d’un domaine : Trouvez des experts reconnus, des journalistes et des leaders d’opinion en cherchant le vocabulaire de leur secteur.
  • Audit des comptes d’une marque : Découvrez les identifiants de marque, les filiales régionales localisées ou les comptes de fans non officiels sur toute la plateforme.
  • Constitution de listes de prospection : Bâtissez des listes de prospects parmi les professionnels pertinents, filtrés par les mots-clés de leur bio publique.

Conseils d’expert pour la Twitter User Search API

  • Utilisez cet endpoint pour découvrir des comptes ; recourez à X Search pour retrouver des tweets ou des posts individuels.
  • results_limit doit être un multiple de 20 (par exemple 20, 40 ou 100) pour s’aligner sur les lots de pagination du fournisseur.
  • Contrôlez les propriétés is_verified et verified_type pour savoir si un compte est officiellement authentifié.
  • Transmettez les noms d’utilisateur découverts à X User Posts ou à X Following List pour explorer plus loin leur graphe d’audience.

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

  • Twitter Profile Scraper API — Récupérez par nom d’utilisateur l’identité publique d’un compte, ses biographies, avatars, images de couverture, statut du compte et statistiques d’audience visibles.
  • Twitter User Tweets Scraper API — Collectez par nom d’utilisateur les posts publics récents, auteurs, médias, hashtags, mentions et l’engagement, hors réponses.
  • Twitter Search API — Trouvez des posts publics par expression de recherche, avec tri par récents ou populaires et limite de résultats configurable.
  • X Followers List API — Collectez les identités des abonnés publics et les indicateurs de profil visibles pour un ou plusieurs noms d’utilisateur X.
  • X Trends API — Collectez des instantanés des tendances X publiques actuelles pour des WOEID numériques connus, avec rang source, requête, description et contexte géographique.
  • X Communities Search API — Trouvez des communautés par mot-clé, avec le nombre de membres et un lien utilisable par les endpoints de membres et de posts.

Explorer d’autres plateformes

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

Twitter User Search API — FAQ

Twitter User Search API recherche des comptes d’utilisateurs publics et des profils de créateurs sur X à partir de requêtes textuelles. Elle renvoie des enregistrements de profils normalisés avec nombres d’abonnés, bios, badges de vérification et URL d’avatars.

L’endpoint X Search cherche des tweets et des posts publics correspondant à des mots-clés, tandis que Twitter User Search cible spécifiquement les comptes d’utilisateurs et les profils de chaînes.

Le fournisseur amont livre les résultats de recherche d’utilisateurs par pages fixes de 20 éléments : les limites demandées doivent donc être un multiple exact de 20.