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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL 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_limit | Facultatif | Nombre 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.
- Préparez une ou plusieurs URL publiques x.com ou twitter.com dont le chemin contient /status/{numeric_post_id}.
- Envoyez urls en POST avec un results_limit de 100 à 2 000 par pas de 100.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- 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_cursorCas 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.
API associées
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.
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts 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