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ètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Tableau de noms d’utilisateur X publics cibles dont il faut récupérer les mentions, avec ou sans @ initial. |
results_limit | Facultatif | Nombre maximal de mentions renvoyées par nom d’utilisateur ; doit être un multiple de 20 compris entre 20 et 2 000. |
start_date | Facultatif | Horodatage 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_date | Facultatif | Horodatage 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.
- Indiquez un ou plusieurs noms d’utilisateur dans usernames et fixez results_limit à un multiple de 20 (jusqu’à 2 000).
- Fournissez au besoin start_date et end_date pour restreindre la période de collecte des mentions.
- Envoyez une requête POST à /v1/x/mentions avec votre clé API SocQ.
- 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.
API associées
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.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community 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 Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API