🐦 Twitter List Timeline Scraper

This actor allows you to fetch the timeline (tweets) from a specific Twitter list. It uses the latest Twitter API interface and supports automatic pagination to collect up to the number of tweets you specify.

Features

• Fetches tweets from a specific Twitter list.
• Supports automatic pagination to retrieve large lists.
• Allows you to specify the maximum number of results (maxResults).
• Returns detailed information for each tweet.

Input

• list_id (string, required): The ID of the Twitter list whose timeline you want to fetch.
• maxResults (integer, optional): Maximum number of tweets to fetch. Default is 90.

Output

The output is an array of tweet objects, each containing:

• tweet_id
• bookmarks
• created_at
• favorites
• text
• lang
• source
• views
• quotes
• replies
• retweets
• media
• author

Example Input

{
  "list_id": "1343798673386434560",
  "maxResults": 120
}

Example Output

[
	{
		"tweet_id": "1928280238766555634",
		"bookmarks": 1,
		"created_at": "Fri May 30 02:40:09 +0000 2025",
		"favorites": 14,
		"text": "ICYMI: Max is changing its name back to #HBO Max this summer.\n\nHow do you feel about the change BACK? 💭 https://t.co/AuF3KPJf0t",
		"lang": "en",
		"source": "<a href=\"https://trueanthem.com\" rel=\"nofollow\">trueanthem_pro2</a>",
		"views": "1500",
		"screen_name": "screenrant",
		"quotes": 0,
		"replies": 4,
		"retweets": 3,
		"media": {
			"photo": [
				{
					"media_url_https": "https://pbs.twimg.com/media/GsKgqKRXEAAdN9r.jpg",
					"id": "1928280236640112640"
				}
			]
		},
		"author": {
			"rest_id": "14892220",
			"name": "Screen Rant",
			"followers": 283881,
			"screen_name": "screenrant",
			"avatar": null,
			"blue_verified": true
		},
		"scrapedAt": "2025-05-30T03:07:15.794Z"
	},
	...
]

Notes

• The actor will stop fetching once it reaches the specified maxResults or there are no more tweets to fetch.
• Make sure the list is public and accessible.