x/
search

Recherchez des posts X publics à partir d’une seule expression ciblée, choisissez l’ordre des plus récents ou des plus populaires, et obtenez contenus, auteurs, engagement, médias, entités et contexte de la requête source.

Twitter Search API

Découverte par requête
Plus récents ou plus populaires
Trace de la requête source
0,7 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 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ètresObligatoireDescription
queryObligatoireMot-clé ou expression de recherche de posts X, obligatoire et non vide, servant à trouver les posts publics correspondants.
results_limitFacultatifPlafond 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_byFacultatifOrdre 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.

  1. Rédigez une expression ciblée et non vide décrivant les posts X que vous cherchez.
  2. Sélectionnez latest ou top, puis fixez results_limit entre 20 et 2 000 par paliers de 20.
  3. Envoyez la requête en POST à /v1/x/search, puis interrogez /v1/tasks/{task_id} jusqu’à la fin de la tâche.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

Twitter Search API — FAQ

Twitter Search API trouve des posts X publics à partir d’une expression de recherche. Elle renvoie le contenu structuré des posts, les auteurs, l’engagement, les médias, les entités, les relations et la requête source.

Indiquez un mot-clé ou une expression non vide qui décrit la marque, le produit, l’événement, la formule ou le sujet que vous souhaitez étudier.

Prenez latest pour privilégier les correspondances récentes et top pour passer en revue les plus en vue. latest est la valeur par défaut.

results_limit vaut 20 par défaut et accepte les multiples de 20 de 20 à 2 000. Il fixe le nombre maximal de résultats demandés.

Un résultat peut comprendre le texte, la langue, les données de l’auteur, l’engagement visible, les médias, les hashtags, les mentions, les horodatages et les relations de conversation.

Oui. extra.search_query contient l’expression envoyée, ce qui garde la correspondance rattachée à sa règle de découverte.

La limite est un plafond de collecte, tandis que le nombre réel dépend des correspondances publiques éligibles au moment où la tâche s’exécute.

Chaque résultat de recherche normalisé renvoyé coûte 0,7 crédit SocQ.