x/
list-posts

The X List Tweets API collects the latest posts and reposts from public X list timelines by list URL, with text, author, likes, views, media and a repost flag on every item, newest first.

X List Tweets API

List URL input
Reposts flagged
Newest posts first
0.7 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

X List Tweets

An X list timeline is the feed of tweets and retweets from the accounts someone has grouped into a list, each with its text, author, likes, comments, reposts, views, attached images or videos, hashtags and mentions. Read together, these posts let you follow what a curated group of journalists, founders or competitors is talking about, see which members' posts draw the most engagement and find out whose content the group keeps passing around.

X List Tweets API Features

  • Timeline of any public list by URLSubmit one or more x.com/i/lists/<id> links to the X List Tweets API and each list's timeline comes back newest first, up to 2,000 tweets per list.
  • Reposts flagged, original author kept apartis_repost marks every repost; author stays the list member who shared it, while reposted_author and reposted_post_id point to the original creator and post.
  • Engagement and media on every postmetrics carries likes, comments, shares and views, and media lists each image or video with its URL, thumbnail, width and height.
  • Hashtags and mentions as separate arrayshashtags and mentions arrive as their own lists, so the topics a list discusses and the accounts its members address can be counted straight from the fields.

X List Tweets API Parameters

ParametersRequiredDescription
urlsRequiredPublic X list URLs in the form https://x.com/i/lists/<numeric id>. Each list's timeline is collected separately.
results_limitOptionalPosts to collect from each list, a multiple of 20 from 20 to 2,000. Defaults to 100.

How to Use the X List Tweets API

Send list URLs to the X List Tweets API, wait for the task to finish, then read the timeline page by page.

  1. POST {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} to /v1/x/list-posts.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read posts from results.items, newest first, and send results.next_cursor back while has_more is 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.

X List Tweets API Use Cases

  • Following a beat through a curated list: Pull the timeline of a journalist or analyst list through the X List Tweets API each morning and read text, author and published_at to see what the group covered since the last run.
  • Ranking the posts a niche reacts to: Keep the original posts (is_repost false) and sort them by views_count and likes_count to find which members' updates drew the most attention.
  • Measuring who a group amplifies: Count reposted_author.username across the reposts to see which outside accounts and which fellow members a list passes along most often.
  • Collecting competitor announcements in one feed: Put rival brand accounts on one list and collect its timeline with the X List Tweets API to capture their launch posts, links and attached media together.
  • Building a topic dataset for a community: Group the hashtags and mentions from a list's posts by published_at to chart which topics and accounts the community discusses over time.

X List Tweets API Pro Tips

  • Filter on is_repost before ranking members by engagement, because a repost carries the original post's likes and views.
  • When several members repost the same post, deduplicate on reposted_post_id so each original is counted once.
  • Raise results_limit in the X List Tweets API when you need plenty of original posts from a busy list, since reposts can take up most of its timeline.
  • A repost's text starts with "RT @user:" and its mentions include that user, so drop reposts or strip the prefix before counting keywords and mentions.
  • On scheduled X List Tweets API runs, keep only items whose id is new to your store, because a newest-first timeline overlaps with the previous run.
  • To see every account feeding the timeline, including members who post rarely, collect the same list with Twitter List Members API.

Beyond the X List Tweets API, use these APIs when you need a different type of public X data.

  • Twitter Tweet Scraper API — Retrieve public post text, authors, engagement, media, hashtags, mentions, and conversation relationships from x.com or twitter.com status URLs.
  • Twitter User Tweets Scraper API — Collect recent public posts, authors, media, hashtags, mentions, and engagement by username with replies excluded.
  • X Post Quotes API — Collect public quote posts for known status URLs with commentary, authors, engagement, media, timestamps, and source-post context.
  • X Post Replies API — Collect public replies from X post URLs with selectable ordering, reply text, authors, visible engagement, media, and parent-post context.
  • Twitter Mentions API — Collect public posts mentioning a specified account.
  • Twitter List Members API — Export the accounts on a list as full profiles with bios, locations and counts.

Explore other platforms

Combine X data with public data from other supported social platforms.

X List Tweets API — FAQ

X List Tweets API is a programmatic interface for collecting the timeline of public X lists from their list URLs. It returns each post or repost with its text, author, likes, comments, shares, views, media, hashtags, mentions and repost source.

Open the list on x.com, copy its URL (it looks like https://x.com/i/lists/1940592907737845989) and submit it in urls. The posts come back newest first, in the same order as the list's own timeline.

It is the number after /i/lists/ in the list's URL. Put the full URL in urls when you submit.

Yes. Reposts by list members are returned and marked with is_repost, with the original post's ID in reposted_post_id and its creator in reposted_author. Filter on is_repost when you want original posts only.

A URL that points to a list that does not exist returns an empty result; the task still succeeds and nothing is charged. Check that the number after /i/lists/ is complete.

Yes. Add each list URL to urls. results_limit counts per list, so three lists at 100 can return up to 300 posts.