x/
post-retweeters

Collectez les profils publics normalisés des comptes ayant reposté des posts X ou Twitter connus, avec dédoublonnage au niveau de la tâche, signaux de compte visibles et métriques de profil.

X Post Retweeters API

Audiences de reposts
Profils publics
Dédoublonnage par tâche
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 Retweeters

Les enregistrements X Post Retweeters désignent les comptes publics vus en train de reposter des URL de statuts X ou Twitter connues, et normalisent leur identité de profil, leurs signaux de compte publics, leurs compteurs visibles et l’heure de collecte. Chaque post source est parcouru indépendamment, puis les profils sauvegardés sont dédoublonnés à l’échelle de la tâche, sans que chaque résultat garde la trace du post source.

Fonctionnalités de la X Post Retweeters API

  • Résolution d’URL de statutAcceptez les URL de statuts publics x.com et twitter.com et obtenez l’identifiant numérique du post, nécessaire pour collecter la liste visible des comptes ayant reposté.
  • Profils de comptes normalisésRenvoie l’ID du profil, le nom d’utilisateur, le nom affiché, l’URL canonique du profil, la biographie, l’avatar, l’image de couverture et les indicateurs publics du compte lorsqu’ils sont disponibles.
  • Métriques de profil visiblesRelève les nombres d’abonnés, d’abonnements, de posts, de médias et de mentions « J’aime » disponibles, avec les horodatages de création du compte et de collecte.
  • Ensemble de résultats unique sur plusieurs postsParcourt chaque post envoyé avec son propre plafond de résultats, puis ne sauvegarde chaque profil normalisé qu’une seule fois pour toute la tâche terminée.

Paramètres de la X Post Retweeters API

ParamètresObligatoireDescription
urlsObligatoireURL de statuts publics x.com ou twitter.com obligatoires, contenant un ID de post numérique ; séparez plusieurs valeurs par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal de profils demandés indépendamment pour chaque post source ; vaut 100 par défaut et accepte les multiples de 100 de 100 à 2 000.

Comment utiliser la X Post Retweeters API

Envoyez des URL de statuts publics connues sous forme de tâche asynchrone, interrogez son état, puis parcourez page par page les profils normalisés uniques.

  1. Préparez une ou plusieurs URL publiques x.com ou twitter.com dont le chemin contient /status/{numeric_post_id}.
  2. Envoyez urls en POST avec un results_limit de 100 à 2 000 par pas de 100.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez /v1/tasks/{task_id}?limit=50 et transmettez results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/post-retweeters" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

Cas d’usage de la X Post Retweeters API

  • Découverte de l’audience qui relaie : Constituez un annuaire unique des comptes publics vus en train de relayer des posts choisis, pour l’étude, la revue ou la préparation d’une prise de contact.
  • Enrichissement des profils de ceux qui repostent : Ajoutez profils canoniques, biographies, images, indicateurs publics de compte, localisations, sites web et métriques visibles à un jeu de données de relais.
  • Recoupement d’audiences entre posts : Lancez un post source par tâche et comparez les ID de profils stables entre les jeux de résultats terminés lorsque le recoupement par post ou l’attribution compte.

Conseils d’expert pour la X Post Retweeters API

  • Ramenez les URL de statut à leur forme canonique et dédoublonnez par ID de post numérique avant de constituer un lot, car rien ne garantit que des formes d’URL différentes d’un même post fusionnent à la validation de l’entrée.
  • Voyez dans results_limit un plafond par post source, non un nombre de résultats garanti : la visibilité publique et la pagination disponible peuvent produire moins de profils.
  • Utilisez une seule URL source par tâche lorsque l’attribution à la source compte, car les profils normalisés ne conservent ni l’URL ni l’ID du post d’origine.
  • Suivez le results.next_cursor opaque de la tâche indépendamment de la pagination de collecte ; le curseur public parcourt des résultats normalisés déjà sauvegardés.
  • Prenez l’ID de profil comme clé de fusion durable entre les tâches et rattachez les compteurs publics changeants à collected_at.
  • Admettez des champs de profil nullables et des résultats vides, car les biographies, images, signaux de compte, compteurs ou la visibilité des reposts peuvent être indisponibles publiquement.

En complément de la X Post Retweeters 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 Followers List API — Collectez les identités des abonnés publics et les indicateurs de profil visibles pour un ou plusieurs noms d’utilisateur X.
  • X Following List API — Collectez les profils suivis par des comptes X publics, avec identité, biographies, signaux de compte, compteurs visibles et noms d’utilisateur sources.
  • 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 API — Lisez des liens de communautés pour obtenir descriptions, nombres de membres, règles et conditions d’adhésion.

Explorer d’autres plateformes

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

X Post Retweeters API — FAQ

X Post Retweeters API récupère les profils publics normalisés des comptes vus en train de reposter un ou plusieurs posts X ou Twitter connus.

Envoyez des URL http ou https sur x.com, www.x.com, m.x.com, mobile.x.com, twitter.com, www.twitter.com, m.twitter.com ou mobile.twitter.com, avec un chemin contenant /status/{numeric_post_id}.

La limite s’applique indépendamment à chaque post source, vaut 100 par défaut et doit être un multiple de 100 compris entre 100 et 2 000.

Un résultat peut inclure l’ID du profil, le nom d’utilisateur, le nom, l’URL canonique, la biographie, l’avatar, l’image de couverture, les signaux de vérification et de confidentialité, les métriques visibles, la date de création du compte, l’heure de collecte et d’autres signaux publics du compte.

Non. Les résultats sont des profils normalisés des comptes ayant reposté ; ils n’incluent ni objets de repost, ni commentaire ajouté, ni contenu de post de citation.

Non. Les profils sont dédoublonnés à l’échelle de la tâche et l’enregistrement normalisé ne conserve ni l’URL ni l’ID de son post source. Envoyez un seul post par tâche si cette attribution est nécessaire.

results_limit est un plafond. Un post peut avoir moins de comptes visibles ayant reposté, la pagination de collecte peut s’arrêter, des comptes indisponibles peuvent manquer, et un même profil n’est sauvegardé qu’une fois pour toute la tâche.

La consommation finale est de 0,5 crédit par profil unique sauvegardé, sans frais de base. L’estimation préfacturée se fonde sur le nombre d’URL envoyées et sur results_limit par post, tandis qu’un résultat vide coûte zéro crédit.