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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé de recherche permettant de trouver les profils d’utilisateurs X publics correspondants. |
results_limit | Facultatif | Nombre 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.
- Renseignez votre terme de recherche dans query et fixez results_limit à un multiple de 20 (jusqu’à 2 000).
- Envoyez une requête POST à /v1/x/search-users avec votre clé API SocQ.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut de la tâche soit succeeded.
- 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.
API associées
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.
- Twitter Tweet Scraper API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API