🐦 Twitter/X Lists Timeline Scraper – Extract Tweets from X Lists

Extract the complete timeline, tweets, retweets, and quoted tweets from any public Twitter/X List. Monitor curated lists of influencers, industries, competitors, or specific communities with detailed metadata, user details, media contents, and engagement metrics. Perfect for competitive intelligence, market research, content curation, and brand monitoring!

📋 Table of Contents

• Features
• Use Cases
• Quick Start
• Input Parameters
• Output Format
• Data Fields Explained
• FAQ

🚀 Features

Complete List Timeline Scraper

• Full Feed Extraction - Extract all tweets, retweets, and quoted tweets from any public Twitter/X List timeline.
• Detailed Author Metadata - Display name, username/screen name, user ID, profile image, verified status, and follower counts of list contributors.
• Engagement Statistics - Monitor impressions/views, likes, retweets, replies, quote count, and bookmarks count.
• Deep Content Parsing - Differentiate between regular tweets, retweets, and quoted tweets with structured nested objects (retweeted_tweet and quoted_tweet).
• Rich Media Assets - Retrieve image and video URLs embedded directly inside tweets.

Reliable Scraping Architecture

• Pagination Support - Automated maxPages controls pagination cursors under the hood to scrape up to 20 pages of list updates.
• No Account Required - Pull data securely from public lists without logging into a personal Twitter/X account or using browser sessions.

🎯 Use Cases

Use Case	Description	Benefits
Competitor Monitoring	Scrape a list containing all your competitors' official accounts	Track product launches, content strategies, and updates in one place
Influencer Tracking	Analyze post frequency and content patterns of niche influencers	Identify trends, verify active influencers
Trend Discovery	Follow curated lists on tech, AI, finance, or web3	Capture news, links, and updates early
Social Media Curations	Aggregate tweets from list contributors to feed database/newsletters	Simplify content aggregation
Community Analytics	Pull tweets from specific community-built X Lists	Measure overall activity, topics, and sentiments

⚡ Quick Start

1️⃣ Single List Timeline Scraping

{
  "listIds": [
    "1234567890123456789"
  ],
  "maxPages": 2
}

2️⃣ Multiple Lists or List URLs

{
  "listIds": [
    "https://x.com/i/lists/1234567890123456789",
    "https://twitter.com/username/lists/987654321098765432"
  ],
  "maxPages": 5
}

📊 Input Parameters

Configuration Options

Parameter	Type	Required	Description	Default
listIds	Array	Yes	List of Twitter/X List IDs or List URLs to scrape. Supports direct numeric IDs and list URLs.
maxPages	Integer	No	Max pages of timeline results to retrieve per list (1 page = 1 API call). Range: 1 to 20.	1

📤 Output Format

List Tweet Result Example

{
  "tweet_id": "1800000000000000000",
  "text": "Excited to share our latest research on artificial intelligence!",
  "screen_name": "ai_researcher",
  "created_at": "Wed Jun 12 14:00:00 +0000 2026",
  "favorites": 845,
  "retweets": 120,
  "replies": 32,
  "quotes": 14,
  "bookmarks": 85,
  "views": "45000",
  "lang": "en",
  "source": "Twitter Web App",
  "author_id": "44196397",
  "author_name": "AI Researcher",
  "author_username": "ai_researcher",
  "author_avatar": "https://pbs.twimg.com/profile_images/1234567890/photo_400x400.jpg",
  "author_verified": true,
  "author_followers": 25000,
  "is_retweet": false,
  "is_quote": false,
  "retweeted_tweet": null,
  "quoted_tweet": null,
  "media": null,
  "list_id": "1234567890123456789",
  "scraped_at": "2026-07-08T10:45:00.000Z"
}

📈 Data Fields Explained

Complete Field Reference

Field	Type	Description
tweet_id	String	Unique status ID of the list tweet.
text	String	Plain-text content of the tweet.
screen_name	String	Username of the author.
created_at	String	Original post timestamp.
favorites	Integer	Favorite/like count.
retweets	Integer	Retweet count.
replies	Integer	Direct reply count.
quotes	Integer	Quote tweet count.
bookmarks	Integer	Bookmark count.
views	String/Number	Impression/views count.
lang	String	Language code of the tweet.
author_id	String	Unique user ID of the tweet author.
author_name	String	Display name of the author.
author_username	String	Screen name/username of the author.
author_avatar	String	URL of the author's profile image.
author_verified	Boolean	Verification status.
author_followers	Integer	Follower count of the author.
is_retweet	Boolean	True if this is a retweet of another post.
is_quote	Boolean	True if this is a quote tweet.
retweeted_tweet	Object	Detailed nested object of the original tweet if is_retweet is true.
quoted_tweet	Object	Detailed nested object of the quoted tweet if is_quote is true.
list_id	String	The list ID being scraped.
scraped_at	String	Extraction timestamp.

❓ FAQ

Q: Can I scrape private Twitter/X lists?

A: No. This actor can only scrape public lists. Private lists will result in access denied errors.

Q: Do I need to be a member of the list to scrape it?

A: No, as long as the list is public, anyone can scrape it.

Q: Can I use the full List URL instead of just the List ID?

A: Yes! The actor automatically parses full URLs like https://x.com/i/lists/123456789 and extracts the ID.

---

Related Actors 🤝

• Twitter X Thread Reader Scraper
• Twitter X Recent Replies Scraper
• Twitter X Profile Scraper
• Twitter X Video Downloader
• X Profile Viewer
• X Follower Scraper
• X Following Scraper
• Twitter Affiliates X Scraper

---

🏷️ Keywords & Tags

twitter list scraper, x list scraper, twitter list timeline, extract twitter list, download x list tweets, twitter feeds aggregator, monitor twitter list, twitter influencer tracker, apify twitter list scraper, x.com lists

---

🚀 Get Started Now

1. Click "Try for free" to run this actor in the Apify Console.
2. Provide one or more List IDs or List URLs in the input array.
3. Configure maxPages to load older list timeline tweets.
4. Export your data as JSON, CSV, or Excel!

⭐ If this actor is useful to your workflow, please leave a star!

---

Built by Sachin Kumar Yadav using Apify Platform