🐦 Twitter Search Scraper

This actor allows you to search for tweets on Twitter using a keyword or phrase. It supports different search types (Top, Latest, Media, People, Lists) and automatic pagination to collect up to the number of tweets you specify.

Features

• Search for tweets by keyword or phrase.
• Supports search types: Top, Latest, Media, People.
• Automatic pagination to retrieve large result sets.
• Specify the maximum number of results (maxResults).
• Returns detailed information for each tweet.

Input

• query (string, required): The search keyword or phrase.
• searchType (string, optional): Type of search result to fetch. One of Top, Latest, Media, People, Lists. Default is Top.
• maxResults (integer, optional): Maximum number of tweets to fetch. Default is 15.

Output

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

• tweet_id
• screen_name
• favorites
• created_at
• text
• lang
• source
• quotes
• replies
• retweets
• views
• entities
• user_info
• media

Example Input

{
  "query": "OpenAI",
  "searchType": "Top",
  "maxResults": 15
}

Example Output

[
	{
		"type": "tweet",
		"tweet_id": "1928111107706868204",
		"screen_name": "ronakkadhi",
		"bookmarks": 166,
		"favorites": 101,
		"created_at": "Thu May 29 15:28:05 +0000 2025",
		"text": "OpenAI quietly dropped a full guide on how to build AI agents from scratch.\n\nMost people won’t read it. I did. Twice.\n\nThis thread breaks it down into a tactical playbook for founders, builders, and operators.\n\nA fast-track guide to building real AI agents🧵 https://t.co/Rr2vhG2bP0",
		"lang": "en",
		"source": "<a href=\"https://typefully.com/\" rel=\"nofollow\">Typefully</a>",
		"quotes": 1,
		"replies": 2,
		"conversation_id": "1928111107706868204",
		"retweets": 38,
		"views": "16364",
		"entities": {
			"hashtags": [],
			"media": [
				{
					"display_url": "pic.x.com/Rr2vhG2bP0",
					"expanded_url": "https://x.com/ronakkadhi/status/1928111107706868204/photo/1",
					"id_str": "1928111101520269315",
					"indices": [
						258,
						281
					],
					"media_key": "3_1928111101520269315",
					"media_url_https": "https://pbs.twimg.com/media/GsIG1M2aUAMLBLg.jpg",
					"type": "photo",
					"url": "https://t.co/Rr2vhG2bP0",
					"ext_media_availability": {
						"status": "Available"
					},
					"features": {
						"large": {
							"faces": [
								{
									"x": 423,
									"y": 140,
									"h": 237,
									"w": 237
								}
							]
						},
						"medium": {
							"faces": [
								{
									"x": 423,
									"y": 140,
									"h": 237,
									"w": 237
								}
							]
						},
						"small": {
							"faces": [
								{
									"x": 239,
									"y": 79,
									"h": 134,
									"w": 134
								}
							]
						},
						"orig": {
							"faces": [
								{
									"x": 423,
									"y": 140,
									"h": 237,
									"w": 237
								}
							]
						}
					},
					"sizes": {
						"large": {
							"h": 800,
							"w": 1200,
							"resize": "fit"
						},
						"medium": {
							"h": 800,
							"w": 1200,
							"resize": "fit"
						},
						"small": {
							"h": 453,
							"w": 680,
							"resize": "fit"
						},
						"thumb": {
							"h": 150,
							"w": 150,
							"resize": "crop"
						}
					},
					"original_info": {
						"height": 800,
						"width": 1200,
						"focus_rects": [
							{
								"x": 0,
								"y": 0,
								"w": 1200,
								"h": 672
							},
							{
								"x": 170,
								"y": 0,
								"w": 800,
								"h": 800
							},
							{
								"x": 219,
								"y": 0,
								"w": 702,
								"h": 800
							},
							{
								"x": 370,
								"y": 0,
								"w": 400,
								"h": 800
							},
							{
								"x": 0,
								"y": 0,
								"w": 1200,
								"h": 800
							}
						]
					},
					"media_results": {
						"result": {
							"media_key": "3_1928111101520269315"
						}
					}
				},
				{
					"display_url": "pic.x.com/Rr2vhG2bP0",
					"expanded_url": "https://x.com/ronakkadhi/status/1928111107706868204/photo/1",
					"id_str": "1928111105479692291",
					"indices": [
						258,
						281
					],
					"media_key": "3_1928111105479692291",
					"media_url_https": "https://pbs.twimg.com/media/GsIG1bmaUAMEYRX.png",
					"type": "photo",
					"url": "https://t.co/Rr2vhG2bP0",
					"ext_media_availability": {
						"status": "Available"
					},
					"features": {
						"large": {
							"faces": []
						},
						"medium": {
							"faces": []
						},
						"small": {
							"faces": []
						},
						"orig": {
							"faces": []
						}
					},
					"sizes": {
						"large": {
							"h": 805,
							"w": 1020,
							"resize": "fit"
						},
						"medium": {
							"h": 805,
							"w": 1020,
							"resize": "fit"
						},
						"small": {
							"h": 537,
							"w": 680,
							"resize": "fit"
						},
						"thumb": {
							"h": 150,
							"w": 150,
							"resize": "crop"
						}
					},
					"original_info": {
						"height": 805,
						"width": 1020,
						"focus_rects": [
							{
								"x": 0,
								"y": 0,
								"w": 1020,
								"h": 571
							},
							{
								"x": 183,
								"y": 0,
								"w": 805,
								"h": 805
							},
							{
								"x": 232,
								"y": 0,
								"w": 706,
								"h": 805
							},
							{
								"x": 384,
								"y": 0,
								"w": 403,
								"h": 805
							},
							{
								"x": 0,
								"y": 0,
								"w": 1020,
								"h": 805
							}
						]
					},
					"media_results": {
						"result": {
							"media_key": "3_1928111105479692291"
						}
					}
				}
			],
			"symbols": [],
			"timestamps": [],
			"urls": [],
			"user_mentions": []
		},
		"user_info": {
			"screen_name": "ronakkadhi",
			"name": "Ronak Kadhi",
			"created_at": "Sun May 13 13:06:18 +0000 2018",
			"description": "Building an AI designer at https://t.co/qvfuOVGxKx Tweeting about AI, Design and Marketing as I see it",
			"rest_id": "995651450620522496",
			"followers_count": 4254,
			"favourites_count": 1279,
			"avatar": "https://pbs.twimg.com/profile_images/995655731800981505/iG8sWGBw_normal.jpg",
			"verified": true,
			"friends_count": 1016,
			"location": null
		},
		"media": {
			"photo": [
				{
					"media_url_https": "https://pbs.twimg.com/media/GsIG1M2aUAMLBLg.jpg",
					"id": "1928111101520269315",
					"sizes": {
						"h": 800,
						"w": 1200
					}
				},
				{
					"media_url_https": "https://pbs.twimg.com/media/GsIG1bmaUAMEYRX.png",
					"id": "1928111105479692291",
					"sizes": {
						"h": 805,
						"w": 1020
					}
				}
			]
		},
		"scrapedAt": "2025-05-30T02:20:28.921Z"
	},
	...
]

Notes

• The actor will stop fetching once it reaches the specified maxResults or there are no more tweets to fetch.
• Make sure your search query complies with Twitter's search policies.