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
| Parameters | Required | Description |
|---|---|---|
urls | Required | Public X list URLs in the form https://x.com/i/lists/<numeric id>. Each list's timeline is collected separately. |
results_limit | Optional | Posts 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.
- POST {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} to /v1/x/list-posts.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.
- 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