🐦 Twitter Timeline Scraper

Extract the latest tweets from any public Twitter user's timeline with detailed metadata.
This actor leverages the Twitter API to fetch tweets, including tweet content, engagement metrics, media, and author information.

Features

• Fetches tweets from a specified user's timeline.
• Supports pagination and automatic fetching up to the specified maxResults.
• Returns rich metadata for each tweet, including media, engagement, and author details.

Input

Field	Type	Description
screenname	string	Twitter username (without @)
maxResults	integer	Maximum number of tweets to fetch

Output

An array of tweet objects, each with the following structure (see below for details):

• tweet_id
• created_at
• text
• favorites
• retweets
• replies
• quotes
• views
• lang
• source
• media (photos/videos)
• author (user info)
• ...and more

Example Output

[
  {
	"tweet_id": "1927977858812760412",
	"bookmarks": 832,
	"created_at": "Thu May 29 06:38:36 +0000 2025",
	"favorites": 24255,
	"text": "https://t.co/CSwbjnzNao",
	"lang": "zxx",
	"source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>",
	"views": "1781258",
	"quotes": 224,
	"entities": {
		"hashtags": [],
		"symbols": [],
		"timestamps": [],
		"urls": [],
		"user_mentions": []
	},
	"replies": 2367,
	"retweets": 3061,
	"conversation_id": "1927977858812760412",
	"media": {
		"video": [
			{
				"media_url_https": "https://pbs.twimg.com/ext_tw_video_thumb/1796190801073950721/pu/img/GFLwceK_ddA8a1sJ.jpg",
				"variants": [
					{
						"content_type": "application/x-mpegURL",
						"url": "https://video.twimg.com/ext_tw_video/1796190801073950721/pu/pl/7lnLBQyUTTdiGa4e.m3u8?tag=14&v=cfc"
					},
					{
						"bitrate": 256000,
						"content_type": "video/mp4",
						"url": "https://video.twimg.com/ext_tw_video/1796190801073950721/pu/vid/avc1/480x270/J4lj36p61IfeGFKK.mp4?tag=14"
					},
					{
						"bitrate": 832000,
						"content_type": "video/mp4",
						"url": "https://video.twimg.com/ext_tw_video/1796190801073950721/pu/vid/avc1/640x360/aZEEXCafUCsVQ_8U.mp4?tag=14"
					},
					{
						"bitrate": 2176000,
						"content_type": "video/mp4",
						"url": "https://video.twimg.com/ext_tw_video/1796190801073950721/pu/vid/avc1/1280x720/Zn-lTHriGHWKYv8K.mp4?tag=14"
					},
					{
						"bitrate": 10368000,
						"content_type": "video/mp4",
						"url": "https://video.twimg.com/ext_tw_video/1796190801073950721/pu/vid/avc1/1920x1080/ijSv3sREG6z6qN5h.mp4?tag=14"
					}
				],
				"aspect_ratio": [
					16,
					9
				],
				"duration": 41770,
				"original_info": {
					"height": 1080,
					"width": 1920,
					"focus_rects": []
				},
				"id": "1796190801073950721"
			}
		]
	},
	"author": {
		"rest_id": "44196397",
		"name": "Elon Musk",
		"screen_name": "elonmusk",
		"avatar": "https://pbs.twimg.com/profile_images/1926284313365979137/o2cF3MeJ_normal.jpg",
		"blue_verified": true
	},
	"scrapedAt": "2025-05-29T09:02:38.547Z"
  },
  ...
]

Notes

• Only public timelines are supported.
• The actor will automatically paginate until maxResults is reached or no more tweets are available.