X (Twitter) List Scraper — Members & Tweets

Scrape X/Twitter List members and List timeline tweets by List URL or numeric ID. Supports bulk lists, pagination, dedup, and retweet filtering. MCP-ready.

Pricing: $0.005/member · $0.003/tweet · $0.00005 actor start

---

What you get

Mode	Fields
Members	userId, username, name, bio, location, followersCount, followingCount, tweetCount, isVerified, isBlueVerified, profileImageUrl, profileUrl
Tweets	tweetId, authorHandle, authorName, text, fullText, likeCount, retweetCount, replyCount, quoteCount, viewCount, createdAt, hashtags, mediaUrls, isRetweet, isReply, lang, tweetUrl

---

Why use this

X Lists are curated user collections — competitors' influence lists, investor radars, journalist rosters, niche community maps. This actor extracts the full member roster and latest tweets from any public list in one run.

Typical use cases:

• Competitor intelligence — scrape a competitor's "Partners" or "Customers" X List
• Journalist outreach — pull members from media-curated reporter lists
• Influencer mapping — download all members of a niche creator list with follower counts
• Feed monitoring — track latest tweets from any public X List timeline

---

Setup — cookies required

X/Twitter requires authentication cookies. The actor does not store them beyond the run.

1. Open x.com in Chrome and log in
2. Press F12 → Application → Cookies → https://x.com
3. Copy the value of auth_token and ct0
4. Paste both into the actor input fields

---

Input

{
  "lists": ["https://x.com/i/lists/1130857490764091392"],
  "mode": "both",
  "auth_token": "YOUR_AUTH_TOKEN",
  "ct0": "YOUR_CT0_TOKEN",
  "maxMembersPerList": 100,
  "maxTweetsPerList": 50,
  "excludeRetweets": false
}

Field	Type	Default	Description
lists	string[]	—	X List URLs (https://x.com/i/lists/ID) or numeric IDs
mode	string	"both"	"members", "tweets", or "both"
auth_token	string	—	Your x.com auth_token cookie (required)
ct0	string	—	Your x.com ct0 CSRF cookie (required)
maxMembersPerList	number	100	Max members to collect per list (1–1000)
maxTweetsPerList	number	50	Max tweets per list timeline (1–500)
excludeRetweets	boolean	false	Skip retweets from tweet results
includeRaw	boolean	false	Attach raw GraphQL response for debugging

---

Output sample

Member row:

{
  "recordType": "member",
  "listId": "1130857490764091392",
  "username": "elonmusk",
  "name": "Elon Musk",
  "bio": "The people who are crazy enough...",
  "followersCount": 180000000,
  "isBlueVerified": true,
  "profileUrl": "https://x.com/elonmusk",
  "scrapedAt": "2026-08-19T12:00:00.000Z"
}

Tweet row:

{
  "recordType": "tweet",
  "listId": "1130857490764091392",
  "tweetId": "1825100000000000000",
  "authorHandle": "techcrunch",
  "text": "Breaking: AI startup raises $500M...",
  "likeCount": 1200,
  "retweetCount": 340,
  "createdAt": "Tue Aug 19 09:30:00 +0000 2026",
  "tweetUrl": "https://x.com/techcrunch/status/1825100000000000000",
  "scrapedAt": "2026-08-19T12:00:00.000Z"
}

---

API example

const run = await client.actor('khadinakbar/x-list-scraper').call({
  lists: ['https://x.com/i/lists/1130857490764091392'],
  mode: 'both',
  auth_token: process.env.TWITTER_AUTH_TOKEN,
  ct0: process.env.TWITTER_CT0,
  maxMembersPerList: 200,
  maxTweetsPerList: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
const members = items.filter(r => r.recordType === 'member');
const tweets = items.filter(r => r.recordType === 'tweet');

---

Limitations & honest contract

• Public lists only. Private lists are inaccessible without membership.
• Cookies expire. Refresh auth_token + ct0 every 30 days or when runs fail.
• X rate limits. Large lists (1000+ members) may trigger rate limiting; reduce maxMembersPerList if needed.
• No liker identities. Tweet engagement (likes/views) counts are scraped but liker/retweeter identities are not collected.

---

Related actors

• X Tweet Scraper — keyword/hashtag/profile tweet search
• X Community Members Scraper — X Community member extraction
• Twitter Profile & Followers Scraper — full profile + follower data

---

Legal

This actor accesses publicly available X.com data using your own authenticated session. You are responsible for complying with X's Terms of Service and all applicable laws. The actor author accepts no liability for how scraped data is used.