X Post Quotes
X Post Quotes collecte les posts de citation publics qui entourent des posts X précis, et renvoie l’identité de l’auteur, le commentaire ajouté, les médias, la date de publication et les données d’engagement visibles, pour le suivi des opinions, l’analyse des sentiments et l’évaluation de la diffusion.
Fonctionnalités de la X Post Quotes API
- Extension aux posts de citationPartez d’une ou plusieurs URL de statuts publics et collectez les posts publics qui citent ces sources, et non les réponses ni les simples profils ayant reposté.
- Limites indépendantes par sourceDemandez de 20 à 2 000 enregistrements par post source, par pas de 20, chaque statut envoyé progressant avec son propre curseur du fournisseur.
- Commentaires normalisésRecevez le texte de la citation, la langue, l’identité de l’auteur, les dates de publication et de collecte, les médias, les entités et l’engagement visible dans une forme unique et cohérente.
- Traçabilité de la source et dédoublonnageConservez l’URL envoyée et l’ID du post parent dans extra, tandis que les ID de posts de citation répétés ne sont stockés qu’une fois pour toute la tâche.
Paramètres de la X Post Quotes API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de statuts publics x.com ou twitter.com, obligatoires. Les variantes d’hôte prises en charge doivent contenir un ID de post numérique après /status/. |
results_limit | Facultatif | Maximum facultatif par post source envoyé. Vaut 100 par défaut et doit être un multiple de 20 de 20 à 2 000. |
Comment utiliser la X Post Quotes API
Envoyez des URL de statuts publics connues, puis interrogez la tâche asynchrone et parcourez page par page ses enregistrements de posts de citation normalisés.
- Préparez des URL publiques x.com ou twitter.com dont le chemin contient /status/{numeric_id}.
- Envoyez le tableau urls en POST à /v1/x/post-quotes, avec results_limit en option, puis conservez le task_id.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- Lisez data.results.items et réutilisez next_cursor tant que has_more vaut true ; ce curseur de résultats est distinct de la pagination du fournisseur.
X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"
curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"
# Poll GET /v1/tasks/{task_id}?limit=50
# Follow data.results.next_cursor while data.results.has_more is trueCas d’usage de la X Post Quotes API
- Étudier les commentaires ajoutés : Constituez un jeu de lecture de ce que des auteurs publics ont ajouté en citant un lancement de produit, une annonce, un lien de recherche ou un post de campagne.
- Repérer les relais publics : Comparez les auteurs de citations et l’engagement visible pour trouver les comptes dont la formulation a suscité une réaction publique notable.
- Archiver des instantanés de citations : Conservez commentaires, références média, horodatages et compteurs au moment de la collecte pour une liste définie de posts sources.
Conseils d’expert pour la X Post Quotes API
- Vérifiez le nom d’hôte et l’ID numérique de /status/ avant l’envoi ; les liens de profil, de recherche et autres liens hors statut sont rejetés.
- Budgétez results_limit par post source et non par tâche : deux URL à 100 peuvent donner une estimation de 200 enregistrements au maximum.
- Attendez-vous à ce qu’un même ID de post de citation n’apparaisse qu’une fois dans les résultats stockés de la tâche, même si plusieurs sources envoyées y mènent.
- Voyez dans la limite demandée un plafond, non une garantie d’exhaustivité : des posts supprimés, protégés, restreints ou exclus de la recherche peuvent manquer.
- Stockez prudemment les champs nullables de médias, d’entités, de conversation et d’engagement, et servez-vous de collected_at pour comparer des compteurs qui évoluent.
API associées
En complément de la X Post Quotes 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 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 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 Post Retweeters API — Collectez, au niveau de la tâche, un ensemble unique de profils publics normalisés des comptes ayant reposté des URL de statuts X ou Twitter connues.
- Twitter Mentions API — Collectez les posts publics qui mentionnent un compte donné.
- X Community Posts API — Lisez les posts publics partagés dans une communauté, avec leur texte, leurs auteurs et leurs nombres d’interactions.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Trends API
- Twitter User Search API
- X Community 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 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