Pricing

Rating

Developer

Actor stats

Categories

Share

🐦 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.