x/
list-posts

Collectez les derniers posts et reposts de timelines de listes X publiques à partir de l’URL de chaque liste, avec texte, auteur, mentions « J’aime », vues, médias et indicateur de repost sur chaque élément, du plus récent au plus ancien.

X List Tweets API

URL de liste en entrée
Reposts signalés
Posts récents en premier
0,7 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 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ètresObligatoireDescription
urlsObligatoireURL 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_limitFacultatifNombre 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.

  1. Envoyez {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} en POST à /v1/x/list-posts.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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.

Explorer d’autres plateformes

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

X List Tweets API — FAQ

X List Tweets API est une interface programmatique qui collecte la timeline de listes X publiques à partir de leurs URL x.com/i/lists ; elle renvoie chaque post ou repost avec son texte, son auteur, ses mentions « J’aime », commentaires, partages et vues, ses médias, ses hashtags, ses mentions et la source du repost.

Ouvrez la liste sur x.com, copiez son URL (de la forme https://x.com/i/lists/1940592907737845989) et envoyez-la dans urls. Les posts reviennent du plus récent au plus ancien, dans le même ordre que la timeline de la liste.

C’est le nombre qui suit /i/lists/ dans l’URL de la liste. Mettez l’URL complète dans urls lors de l’envoi.

Oui. Les reposts des membres de la liste sont renvoyés et marqués par is_repost, avec l’ID du post d’origine dans reposted_post_id et son créateur dans reposted_author. Filtrez sur is_repost si vous ne voulez que les posts originaux.

Une URL qui pointe vers une liste inexistante renvoie un résultat vide ; la tâche réussit quand même et rien n’est facturé. Vérifiez que le nombre qui suit /i/lists/ est complet.

Oui. Ajoutez l’URL de chaque liste dans urls. results_limit s’applique à chaque liste : trois listes à 100 peuvent donc renvoyer jusqu’à 300 posts.