x/
post-quotes

Collectez les posts de citation publics d’URL de statuts X connues, avec commentaire, identité de l’auteur, médias, horodatages, contexte de conversation et métriques d’engagement visibles.

X Post Quotes API

Commentaires de citation
Contexte du post d’origine
Limites par post
0,5 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

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ètresObligatoireDescription
urlsObligatoireURL 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_limitFacultatifMaximum 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.

  1. Préparez des URL publiques x.com ou twitter.com dont le chemin contient /status/{numeric_id}.
  2. Envoyez le tableau urls en POST à /v1/x/post-quotes, avec results_limit en option, puis conservez le task_id.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. 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 true

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

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.

Explorer d’autres plateformes

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

X Post Quotes API — FAQ

X Post Quotes API est une interface programmatique qui collecte les posts de citation publics faisant référence à des URL de statuts X connues. Elle renvoie commentaires, auteurs, engagement, médias, horodatages et contexte du post source sous forme normalisée.

Fournissez un tableau urls non vide de liens publics x.com ou twitter.com dont le chemin contient /status/ suivi d’un ID de post numérique.

La collecte cible les posts de citation renvoyés pour chaque statut source. Les réponses et les comptes qui n’ont fait que reposter la source relèvent de ressources distinctes.

Il vaut 100 par défaut pour chaque URL source envoyée et accepte les multiples de 20 de 20 à 2 000. Les résultats publics disponibles peuvent être moins nombreux que le plafond demandé.

Les pages du fournisseur sont dédoublonnées par ID de post pour chaque source, et la sauvegarde ne stocke qu’une fois le même ID de post de citation normalisé pour l’ensemble de la tâche.

La tâche estime 0,5 crédit pour chaque résultat demandé sur l’ensemble des URL envoyées, puis règle 0,5 crédit par résultat unique sauvegardé et rembourse les crédits prélevés d’avance mais non utilisés.