X List Tweets
La timeline d’une liste X est le fil des tweets et retweets publiés par les comptes que quelqu’un a regroupés dans une liste, chacun avec son texte, son auteur, ses mentions « J’aime », commentaires, reposts et vues, ses images ou vidéos jointes, ses hashtags et ses mentions. Lus ensemble, ces posts permettent de suivre les sujets d’un groupe choisi de journalistes, de fondateurs ou de concurrents, de voir quels membres suscitent le plus d’engagement et de découvrir de qui le groupe relaie sans cesse les contenus.
Fonctionnalités de la X List Tweets API
- La timeline de toute liste publique par URLEnvoyez un ou plusieurs liens x.com/i/lists/<id> : la timeline de chaque liste revient du plus récent au plus ancien, jusqu’à 2 000 tweets par liste.
- Reposts signalés, auteur d’origine à partis_repost marque chaque repost ; author reste le membre de la liste qui l’a partagé, tandis que reposted_author et reposted_post_id désignent le créateur et le post d’origine.
- Engagement et médias sur chaque postmetrics contient les mentions « J’aime », commentaires, partages et vues, et media liste chaque image ou vidéo avec son URL, sa miniature, sa largeur et sa hauteur.
- Hashtags et mentions dans des tableaux distinctshashtags et mentions arrivent sous forme de listes propres : les sujets abordés dans une liste et les comptes auxquels ses membres s’adressent se comptent directement à partir de ces champs.
Paramètres de la X List Tweets API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de listes X publiques au format https://x.com/i/lists/<numeric id>. La timeline de chaque liste est collectée séparément. |
results_limit | Facultatif | Nombre de posts à collecter dans chaque liste, multiple de 20 compris entre 20 et 2 000. 100 par défaut. |
Comment utiliser la X List Tweets API
Envoyez des URL de listes, attendez la fin de la tâche, puis lisez la timeline page par page.
- Envoyez {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} en POST à /v1/x/list-posts.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les posts dans results.items, du plus récent au plus ancien, et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/list-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Reposts arrive with is_repost set to true and the original creator in reposted_author.Cas d’usage de la X List Tweets API
- Suivre un secteur grâce à une liste choisie : Récupérez chaque matin la timeline d’une liste de journalistes ou d’analystes et lisez text, author et published_at pour voir ce que le groupe a couvert depuis la dernière collecte.
- Classer les posts qui font réagir une niche : Gardez les posts originaux (is_repost à false) et triez-les par views_count et likes_count pour trouver les membres dont les publications ont le plus retenu l’attention.
- Mesurer qui un groupe amplifie : Comptez reposted_author.username sur l’ensemble des reposts pour voir quels comptes extérieurs et quels autres membres une liste relaie le plus souvent.
- Réunir les annonces des concurrents dans un seul fil : Placez les comptes de marques concurrentes dans une liste et collectez sa timeline pour capter ensemble leurs posts de lancement, leurs liens et leurs médias joints.
- Constituer un jeu de données thématique pour une communauté : Regroupez les hashtags et mentions des posts d’une liste par published_at pour représenter dans le temps les sujets et les comptes dont parle la communauté.
Conseils d’expert pour la X List Tweets API
- Filtrez sur is_repost avant de classer les membres par engagement, car un repost porte les mentions « J’aime » et les vues du post d’origine.
- Quand plusieurs membres repostent le même post, dédoublonnez sur reposted_post_id pour compter chaque original une seule fois.
- Augmentez results_limit si vous avez besoin de nombreux posts originaux d’une liste très active, car les reposts peuvent occuper l’essentiel de sa timeline.
- Le texte d’un repost commence par « RT @user: » et ses mentions incluent cet utilisateur : écartez les reposts ou retirez ce préfixe avant de compter mots-clés et mentions.
- Lors des collectes planifiées, ne gardez que les éléments dont l’id est nouveau dans votre base, car une timeline triée du plus récent au plus ancien recoupe la collecte précédente.
- Pour voir tous les comptes qui alimentent la timeline, y compris les membres qui publient rarement, collectez la même liste avec Twitter List Members API.
API associées
En complément de la X List Tweets 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 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 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.
- Twitter Mentions API — Collectez les posts publics qui mentionnent un compte donné.
- Twitter List Members API — Exportez les comptes d’une liste sous forme de profils complets avec bio, localisation et compteurs.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers 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