x/
mentions

Collectez les tweets publics qui mentionnent l’identifiant d’un utilisateur cible, avec filtrage par période et métriques d’engagement.

Twitter Mentions API

Mentions de marque
Conversations entrantes
Suivi des mentions
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 Mentions

Suivre les mentions publiques révèle la perception d’une marque, les demandes des clients et les échanges entrants sur X. Les enregistrements de mentions normalisés rassemblent le texte des posts, les identifiants des auteurs, les horodatages, les médias joints et les compteurs d’engagement publics, sans authentification auprès de la plateforme.

Fonctionnalités de la Twitter Mentions API

  • Suivi des mentions publiquesRécupérez les tweets publics qui mentionnent n’importe quel nom d’utilisateur cible, sans exiger les identifiants de connexion du compte visé.
  • Collecte bornée par une fenêtre de datesRestreignez les flux de mentions avec les filtres start_date et end_date, exprimés en dates ISO ou en secondes Unix.
  • Détails de l’auteur et du tweetRecevez des enregistrements de posts normalisés contenant le texte intégral du tweet, les profils d’auteurs, les médias joints et les liens permanents.
  • Métriques d’engagementExtrayez les nombres de mentions « J’aime », de commentaires, de reposts, de citations, de favoris et de vues pour chaque mention trouvée.

Paramètres de la Twitter Mentions API

ParamètresObligatoireDescription
usernamesObligatoireTableau de noms d’utilisateur X publics cibles dont il faut récupérer les mentions, avec ou sans @ initial.
results_limitFacultatifNombre maximal de mentions renvoyées par nom d’utilisateur ; doit être un multiple de 20 compris entre 20 et 2 000.
start_dateFacultatifHorodatage de début facultatif au format ISO (YYYY-MM-DD) ou en secondes Unix, pour ne garder que les mentions à partir de cet instant.
end_dateFacultatifHorodatage de fin facultatif au format ISO (YYYY-MM-DD) ou en secondes Unix, pour ne garder que les mentions antérieures à cet instant.

Comment utiliser la Twitter Mentions API

Envoyez un nom d’utilisateur cible et une période facultative sous forme de tâche asynchrone, puis interrogez la tâche pour obtenir les enregistrements de mentions.

  1. Indiquez un ou plusieurs noms d’utilisateur dans usernames et fixez results_limit à un multiple de 20 (jusqu’à 2 000).
  2. Fournissez au besoin start_date et end_date pour restreindre la période de collecte des mentions.
  3. Envoyez une requête POST à /v1/x/mentions avec votre clé API SocQ.
  4. Interrogez /v1/tasks/{task_id} et parcourez data.results.items page par page avec next_cursor.
curl -X POST "https://api.socq.ai/v1/x/mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@OpenAI"],"results_limit":20}'

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

Cas d’usage de la Twitter Mentions API

  • Veille sur la réputation d’une marque : Suivez presque en temps réel les mentions entrantes, les avis et le sentiment autour de l’identifiant de votre entreprise.
  • Tri des demandes du support client : Repérez les réclamations restées sans réponse, les bugs produit ou les retours adressés à vos comptes de support.
  • Écoute de la présence des dirigeants : Surveillez les mentions et réponses adressées aux comptes de la direction pour mesurer la réaction du secteur aux annonces.

Conseils d’expert pour la Twitter Mentions API

  • results_limit doit être un multiple de 20 (par exemple 20, 40 ou 100) pour correspondre à la taille de page du fournisseur.
  • Les dates ISO comme 2026-09-01 sont converties automatiquement par le backend en horodatages Unix UTC.
  • Cet endpoint renvoie les tweets qui mentionnent le compte ; pour obtenir les posts publiés par le compte lui-même, utilisez X User Posts.
  • Associez-le à X Post Replies pour suivre en détail les fils de conversation issus des tweets de mention importants.

En complément de la Twitter Mentions 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.
  • 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.
  • X Post Quotes API — Collectez les citations publiques de statuts connus à partir de leur URL, avec commentaire, auteurs, engagement, médias, horodatages et contexte du post source.
  • X Community Posts API — Lisez les posts publics partagés dans une communauté, avec leur texte, leurs auteurs et leurs nombres d’interactions.
  • X Thread Context API — Lisez un post avec les messages précédents de sa chaîne de réponses, les réponses publiques et les ID de relation.

Explorer d’autres plateformes

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

Twitter Mentions API — FAQ

Twitter Mentions API collecte les tweets et posts publics qui mentionnent des identifiants d’utilisateurs précis sur X. Elle renvoie des données de posts normalisées, les informations sur l’auteur, les horodatages et les métriques d’engagement, dans des limites de dates facultatives.

Non. L’endpoint interroge les mentions accessibles publiquement à partir des seuls noms d’utilisateur publics ; aucun OAuth de compte client ni jeton de connexion d’utilisateur n’est requis.

Le fournisseur de données amont livre les mentions par pages distinctes de 20 éléments : les requêtes doivent donc respecter ce pas de lot.