Twitter User Media Scraper

This actor allows you to fetch the media content (photos and videos) posted by a specified Twitter account. It uses the latest Twitter API interface and supports automatic pagination to collect up to the number of media items you specify.

Features

• Fetches media content (photos and videos) from any Twitter user's timeline.
• Supports automatic pagination to retrieve large lists.
• Allows you to specify the maximum number of results (maxResults).
• Returns detailed information for each media item, including URLs and metadata.

Input

• screenname (string, required): The Twitter username whose media you want to fetch.
• maxResults (integer, optional): Maximum number of media items to fetch. Default is 10.

Output

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

• tweet_id
• bookmarks
• created_at
• favorites
• text
• lang
• source
• views
• quotes
• replies
• retweets
• conversation_id
• media (containing photo and video information)
• author (user information)

Example Input

{
  "screenname": "x",
  "maxResults": 10
}

Example Output

[
	{
		"tweet_id": "1922699805056229677",
		"bookmarks": 69,
		"created_at": "Wed May 14 17:05:30 +0000 2025",
		"favorites": 1637,
		"text": "call me if you need your old @ back 🖤 https://t.co/pfLDzFaMrY",
		"lang": "en",
		"source": "<a href=\"https://mobile.twitter.com\" rel=\"nofollow\">Twitter Web App</a>",
		"views": "624940",
		"quotes": 16,
		"replies": 379,
		"retweets": 181,
		"conversation_id": "1922699805056229677",
		"media": {
			"photo": [
				{
					"media_url_https": "https://pbs.twimg.com/media/Gq7L8flW4AAvVmC.jpg",
					"id": "1922698331064557568"
				}
			]
		},
		"author": {
			"rest_id": "783214",
			"name": "X",
			"screen_name": "X",
			"avatar": null,
			"blue_verified": true
		},
		"quoted": {
			"tweet_id": "1922661168729997670",
			"bookmarks": 337,
			"created_at": "Wed May 14 14:31:58 +0000 2025",
			"favorites": 9228,
			"text": "Your move, @X.",
			"lang": "en",
			"views": "1047484",
			"quotes": 138,
			"replies": 189,
			"retweets": 1165,
			"conversation_id": "1922661168729997670",
			"author": {
				"rest_id": "89090040",
				"name": "Max",
				"screen_name": "StreamOnMax",
				"avatar": null,
				"blue_verified": true
			},
			"media": []
		},
		"scrapedAt": "2025-05-30T01:20:24.243Z"
	},
	...
]

Notes

• The actor will stop fetching once it reaches the specified maxResults or there are no more media items to fetch.
• Make sure the target account is public and not protected.