Twitter Search
Les résultats d’une recherche sur X sont des posts publics retenus pour une requête, et chacun d’eux porte sa langue, son auteur, ses médias, ses entités, son contexte de conversation et son engagement visible. Garder la requête à côté de chaque enregistrement rend plus simple l’audit des veilles thématiques récurrentes, de l’écoute d’un lancement et des comparaisons entre jeux de résultats.
Fonctionnalités de la Twitter Search API
- Découverte à partir d’une seule expressionEnvoyez un mot-clé ou une expression de recherche non vide, et transformez les posts X publics correspondants en enregistrements structurés.
- Deux ordres pour deux façons de chercherChoisissez latest pour suivre les correspondances récentes ou top pour examiner les plus en vue ; latest est la valeur par défaut.
- Un plafond de résultats adaptéDemandez de 20 à 2 000 résultats par paliers de 20 pour fixer la profondeur maximale de la collecte.
- Des correspondances qui gardent leur requêteTexte, auteur, engagement, médias, entités, horodatages et champs de relation sont réunis avec extra.search_query et collected_at.
Paramètres de la Twitter Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé ou expression de recherche de posts X, obligatoire et non vide, servant à trouver les posts publics correspondants. |
results_limit | Facultatif | Plafond facultatif du nombre de résultats demandés. La valeur par défaut est 20 ; sont acceptés les multiples de 20 de 20 à 2 000. |
sort_by | Facultatif | Ordre facultatif : latest pour les correspondances récentes, top pour les plus en vue. La valeur par défaut est latest. |
Comment utiliser la Twitter Search API
Formulez une question de recherche précise sous forme d’expression, sélectionnez l’ordre qui lui convient et conservez la requête avec les posts obtenus.
- Rédigez une expression ciblée et non vide décrivant les posts X que vous cherchez.
- Sélectionnez latest ou top, puis fixez results_limit entre 20 et 2 000 par paliers de 20.
- Envoyez la requête en POST à /v1/x/search, puis interrogez /v1/tasks/{task_id} jusqu’à la fin de la tâche.
- Enregistrez data.results.items, puis suivez next_cursor jusqu’à ce que has_more passe à false.
curl -X POST "https://api.socq.ai/v1/x/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"artificial intelligence","results_limit":40,"sort_by":"latest"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Twitter Search API
- Écouter autour d’un lancement nommé : Cherchez le nom d’un produit, d’une version, d’une conférence ou d’une campagne, puis classez les posts trouvés selon leur date de publication et de collecte.
- Suivre les mentions d’une marque ou d’un produit : Réunissez auteurs, texte, engagement visible, hashtags, mentions et médias pour un nom ou une formule précis.
- Cartographier un sujet en cours de formation : Avec latest, suivez les nouveaux posts ; avec top, examinez les contenus les plus en vue pour une même expression de recherche.
- Entretenir un jeu de données de requête récurrente : Conservez extra.search_query avec chaque résultat, relancez une expression versionnée et n’ajoutez que les ID de posts encore inconnus.
Conseils d’expert pour la Twitter Search API
- Commencez par une expression ciblée, examinez les résultats, puis élargissez la formulation seulement si la couverture est trop étroite.
- Prenez latest pour une écoute sensible au temps, et top lorsque les posts les plus en vue comptent davantage que la chronologie.
- Choisissez results_limit parmi les multiples de 20 et voyez-y un plafond, non un nombre de résultats garanti.
- Versionnez la requête dès que ses termes changent, afin que les jeux de résultats récurrents restent comparables.
- Dédoublonnez sur l’id du post en gardant extra.search_query et collected_at pour le contexte de découverte.
API associées
En complément de la Twitter Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques X.
- Twitter Tweet Scraper API — Récupérez le texte des posts publics, auteurs, l’engagement, médias, hashtags, mentions et relations de conversation à partir d’URL de statuts x.com ou twitter.com.
- 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.
- X Post Replies API — Collectez les réponses publiques à partir d’URL de posts X avec tri au choix, texte des réponses, auteurs, engagement visible, médias et contexte du post parent.
- 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.
- Twitter User Search API — Trouvez des comptes X publics par mot-clé.
- 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 User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes 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