Actor - Twitter Search Scraper

🐦 Twitter Search Scraper

The Twitter Search Scraper provides powerful tools to extract data from Twitter's search functionality, allowing you to find tweets based on keywords, phrases, and advanced search parameters.

🚀 Features and Functionality

Extremely detailed tweet information for data mining.

Multi-language support on Twitter. Globally working Twitter search actor. No restrictions!

Geo-target the tweets with advanced search capabilities. Integrate into your system with ease.

Lightning speed. Extreme efficiency. Suitable for integration into any platform.

Query Wizard: Easy-to-use Input for non-technical users. Create Twitter Advanced Search effortlessly.

A list of filters that you can easily use. Target your tweet search with precision!

• Custom Start URLs: Begin scraping from search query URLs.

  • Examples:
    • https://x.com/search?q=real%20madrid&src=typed_query
    • https://x.com/search?q=from%3AKMbappe&src=typed_query

• Search Queries: Provide a list of keywords or phrases to find tweets that match specific topics, such as "barca" or "atletico madrid"

• Authentication Support: Use Twitter authentication tokens for improved reliability and access to more data.

• Search Modes:

  • Choose between:
    • : Most recent tweets
    • : Most popular tweets

• Date Filters:

  • Define specific date ranges for scraping:
    • Tweets newer than a specific date (YYYY-MM-DD)
    • Tweets older than a specific date (YYYY-MM-DD)

• Content Filters:

  • Customize the type of tweets to scrape:
    • Only tweets with media (images, videos, or GIFs)
    • Only tweets from verified users
    • Exclude replies, retweets, or links

• Tweet Stats Filters: Filter tweets based on minimum likes, replies, or retweets.

• Account Filters:

  • Scrape tweets:
    • From a specific account.
    • To a specific account.
    • Mentioning a specific account.

• Language and Location: Limit results to specific languages or find tweets near a defined location.

• Proxy Configuration: Use advanced proxy settings to ensure anonymous and efficient scraping.

• Limitations: Set limits on the number of tweets or pages to scrape for optimized performance.

These features allow for a highly customizable and efficient search process, suitable for various data collection needs.

😎 Who needs this?

Twitter Search Scraper is designed to provide enriched search data with high speed in a cost-effective manner. It serves a wide range of users:

• Cryptocurrency Analysts and Investors - can use Twitter Search Scraper to track sentiment, key influencers' opinions, and market-moving announcements related to cryptocurrencies. Catch the panic buy or panic sell right away.
• Market Research Analysts can use Twitter Search Scraper to gather public opinion and trends on different products, services, or topics. By analyzing tweets, they can identify consumer behavior patterns, preferences, and market trends, helping companies make informed decisions.
• Academic Researchers can use Twitter Search Scraper to analyze social behaviors, communication patterns, and public opinion on various topics. This can aid in understanding societal trends, public reactions to events, and the spread of information or misinformation.
• Human Resources and Recruitment Specialists can use Twitter Search Scraper to monitor industry trends, understand job market sentiments, and identify potential candidates for recruitment, enhancing their talent acquisition strategies.

🔧 Bugs, fixes, updates, and changelog

This scraper is under active development. If you have any feature requests you can create an issue from here.

⚙️ Input and Definitions

Field	Type	Description
startUrls	array	Twitter (X) search URLs.
searchTerms	array	Search terms or queries you want to search from Twitter (X). Check this page for further reference.
sort	String	Sort order for search tweets. It can be either "Latest" or "Top".
authTokens	array	Authentication tokens for Twitter (X) to improve reliability and access more data.
maxItems	number	Maximum number of items that you want to receive as output
tweetLanguage	string	Restricts tweets to the given language, given by an ISO 639-1 code.
onlyVerifiedUsers	boolean	Returns only tweets by users who are verified.
onlyTwitterBlue	boolean	Returns only tweets by users who are Twitter Blue subscribers.
onlyImage	boolean	Returns only tweets that contain images.
onlyVideo	boolean	Returns only tweets that contain videos.
onlyQuote	boolean	Returns only tweets that are quotes.
author	String	Returns tweets sent by the given user. It should be a Twitter (X) Handle.
inReplyTo	String	Returns tweets that are replies to the given user. It should be a Twitter (X) Handle.
mentioning	String	Returns tweets mentioning the given user. It should be a Twitter (X) Handle.
geotaggedNear	String	Returns tweets sent near the given location.
withinRadius	String	Returns tweets sent within the given radius of the given location.
geocode	String	Returns tweets sent by users located within a given radius of the given latitude/longitude.
placeObjectId	String	Returns tweets tagged with the given place.
minimumRetweets	number	Returns tweets with at least the given number of retweets.
minimumFavorites	number	Returns tweets with at least the given number of favorites.
minimumReplies	number	Returns tweets with at least the given number of replies.
start	String	Returns tweets sent after the given date.
end	String	Returns tweets sent before the given date.
includeSearchTerms	boolean	If selected, a field will be added to each tweet about the search term that was used to find it.
customMapFunction	string	Function that takes each of the objects as argument and returns data that will be mapped by the function itself.
proxy	object	Select proxies to be used by your crawler.

This solution requires the use of Proxy servers, either your own proxy servers or you can use Apify Proxy.

Tip

Important: You must provide your own Twitter/X authentication tokens in the authTokens array for the scraper to work. These can be obtained from your Twitter accounts.

When you want to scrape over a specific search URL, just copy and paste the link as one of the startUrl.

If you would like to scrape only the first page of search results then put the link for the page and have the endPage as 1.

With the last approach that is explained above you can also fetch any interval of pages. If you provide the 5th page of a search and define the endPage parameter as 6 then you'll have the 5th and 6th pages only.

Compute Unit Consumption

The actor is optimized to run blazing fast and scrape many tweets as possible. Therefore, it forefronts all tweet detail requests. If the actor doesn't block very often it'll scrape 100 tweets in 20 seconds with ~0.02-0.025 compute units.

Twitter Search Scraper Input example

{
    "proxy": {
        "useApifyProxy": true
    },
    "startUrls": [
        "https://x.com/KMbappe",
        "https://x.com/search?q=real%20madrid&src=typed_query",
        "https://x.com/realmadrid/status/1877491794000412879"
    ],
    "searchQueries": [
        "barcelona",
        "atletico madrid"
    ],
    "searchMode": "Latest",
    "maxItems": 100,
    "endPage": 5,
    "authTokens": [
        "auth_token_example_1",
        "auth_token_example_2"
    ],
}

During the Run

During the run, the actor will output messages letting you know what is going on. Each message always contains a short label specifying which page from the provided list is currently specified. When items are loaded from the page, you should see a message about this event with a loaded item count and total item count for each page.

If you provide incorrect input to the actor, it will immediately stop with a failure state and output an explanation of what is wrong.

Tweet Export

During the run, the actor stores results into a dataset. Each tweet is a separate item in the dataset.

You can manage the results in any language (Python, PHP, Node JS/NPM). See the FAQ or our API reference to learn more about getting results from this Twitter Search actor.

Scraped Twitter Properties

The structure of each tweet looks like this:

Tweet Detail

{
	"id": "1877102356627673443",
	"url": "https://x.com/10Ronaldinho/status/1877102356627673443",
	"text": "Hermosos recuerdos en Barcelona... Sempre Barça!!!!! https://t.co/1ljiuvNHf9",
	"retweetCount": 4078,
	"replyCount": 357,
	"likeCount": 58982,
	"quoteCount": 147,
	"createdAt": "Wed Jan 08 21:17:31 +0000 2025",
	"lang": "es",
	"protected": false,
	"bookmarkCount": 421,
	"isReply": false,
	"entities": {
		"hashtags": [],
		"media": [
			{
				"display_url": "pic.x.com/1ljiuvNHf9",
				"expanded_url": "https://x.com/10Ronaldinho/status/1877102356627673443/photo/1",
				"id_str": "1877102283202162688",
				"indices": [
					53,
					76
				],
				"media_key": "3_1877102283202162688",
				"media_url_https": "https://pbs.twimg.com/media/GgzOlM1W8AAXri7.jpg",
				"type": "photo",
				"url": "https://t.co/1ljiuvNHf9",
				"ext_media_availability": {
					"status": "Available"
				},
				"features": {
					"all": {
						"tags": [
							{
								"user_id": "96951800",
								"name": "FC Barcelona",
								"screen_name": "FCBarcelona",
								"type": "user"
							}
						]
					},
					"large": {
						"faces": []
					},
					"medium": {
						"faces": []
					},
					"small": {
						"faces": []
					},
					"orig": {
						"faces": []
					}
				},
				"sizes": {
					"large": {
						"h": 1280,
						"w": 1280,
						"resize": "fit"
					},
					"medium": {
						"h": 1200,
						"w": 1200,
						"resize": "fit"
					},
					"small": {
						"h": 680,
						"w": 680,
						"resize": "fit"
					},
					"thumb": {
						"h": 150,
						"w": 150,
						"resize": "crop"
					}
				},
				"original_info": {
					"height": 1280,
					"width": 1280,
					"focus_rects": [
						{
							"x": 0,
							"y": 0,
							"w": 1280,
							"h": 717
						},
						{
							"x": 0,
							"y": 0,
							"w": 1280,
							"h": 1280
						},
						{
							"x": 111,
							"y": 0,
							"w": 1123,
							"h": 1280
						},
						{
							"x": 352,
							"y": 0,
							"w": 640,
							"h": 1280
						},
						{
							"x": 0,
							"y": 0,
							"w": 1280,
							"h": 1280
						}
					]
				},
				"media_results": {
					"result": {
						"media_key": "3_1877102283202162688"
					}
				}
			}
		],
		"symbols": [],
		"timestamps": [],
		"urls": [],
		"user_mentions": []
	},
	"extentedEntities": {
		"media": [
			{
				"display_url": "pic.x.com/1ljiuvNHf9",
				"expanded_url": "https://x.com/10Ronaldinho/status/1877102356627673443/photo/1",
				"id_str": "1877102283202162688",
				"indices": [
					53,
					76
				],
				"media_key": "3_1877102283202162688",
				"media_url_https": "https://pbs.twimg.com/media/GgzOlM1W8AAXri7.jpg",
				"type": "photo",
				"url": "https://t.co/1ljiuvNHf9",
				"ext_media_availability": {
					"status": "Available"
				},
				"features": {
					"all": {
						"tags": [
							{
								"user_id": "96951800",
								"name": "FC Barcelona",
								"screen_name": "FCBarcelona",
								"type": "user"
							}
						]
					},
					"large": {
						"faces": []
					},
					"medium": {
						"faces": []
					},
					"small": {
						"faces": []
					},
					"orig": {
						"faces": []
					}
				},
				"sizes": {
					"large": {
						"h": 1280,
						"w": 1280,
						"resize": "fit"
					},
					"medium": {
						"h": 1200,
						"w": 1200,
						"resize": "fit"
					},
					"small": {
						"h": 680,
						"w": 680,
						"resize": "fit"
					},
					"thumb": {
						"h": 150,
						"w": 150,
						"resize": "crop"
					}
				},
				"original_info": {
					"height": 1280,
					"width": 1280,
					"focus_rects": [
						{
							"x": 0,
							"y": 0,
							"w": 1280,
							"h": 717
						},
						{
							"x": 0,
							"y": 0,
							"w": 1280,
							"h": 1280
						},
						{
							"x": 111,
							"y": 0,
							"w": 1123,
							"h": 1280
						},
						{
							"x": 352,
							"y": 0,
							"w": 640,
							"h": 1280
						},
						{
							"x": 0,
							"y": 0,
							"w": 1280,
							"h": 1280
						}
					]
				},
				"media_results": {
					"result": {
						"media_key": "3_1877102283202162688"
					}
				}
			}
		]
	},
	"author": {
		"username": "10Ronaldinho",
		"url": "https://x.com/10Ronaldinho",
		"id": "29479000",
		"name": "Ronaldinho",
		"isVerified": false,
		"isBlueVerified": true,
		"profilePicture": "https://pbs.twimg.com/profile_images/1537593562619060225/AmmxIwWi_normal.jpg",
		"coverPicture": "https://pbs.twimg.com/profile_banners/29479000/1650911561",
		"description": "Twitter oficial de Ronaldinho Gaúcho. Duas vezes eleito o melhor do mundo pela FIFA.\n\n@BetifyOfficial embaixador\nhttps://t.co/jctU4nkSvp",
		"location": "",
		"followers": 21437149,
		"following": 152,
		"canDm": false,
		"canMediaTag": false,
		"createdAt": "Tue Apr 07 16:11:50 +0000 2009",
		"entities": {
			"description": {
				"urls": [
					{
						"display_url": "bit.ly/RonniexBetify",
						"expanded_url": "https://bit.ly/RonniexBetify",
						"url": "https://t.co/jctU4nkSvp",
						"indices": [
							113,
							136
						]
					}
				]
			},
			"url": {
				"urls": [
					{
						"display_url": "nooke.ag",
						"expanded_url": "http://www.nooke.ag",
						"url": "https://t.co/f6O6lqd6yM",
						"indices": [
							0,
							23
						]
					}
				]
			}
		},
		"fastFollowersCount": 0,
		"favouritesCount": 1552,
		"listedCount": 26192,
		"hasCustomTimelines": false,
		"isTranslator": false,
		"mediaCount": 3449,
		"statusesCount": 7101,
		"withheldInCountries": [],
		"affiliatesHighlightedLabel": {}
	}
}

Contact

Please visit us through epctex.com to see all the products that are available for you. If you are looking for any custom integration or so, please reach out to us through the chat box in epctex.com. In need of support? business@epctex.com is at your service.