Twitter/X scraper is Lightning-fast with 60+ advanced filters. Extract tweets by engagement, media, users, keywords, time, and location. Supports Latest/Top sorting, threads, quotes, and polls. Returns profiles, media URLs, engagement stats, and metadata.
Enter your search terms here for quick and easy Twitter searches. Supports Twitter's powerful search operators for precise results. You can use this simple search OR configure advanced filters below - at least one must be provided.
Default value of this property is "mikolabs"
Query Type
queryTypeEnumOptional
Choose your search strategy: 'Latest' for real-time, chronological results or 'Top' for the most popular and engaging tweets.
Value options:
"Latest": string"Top": string
Default value of this property is "Latest"
Number of Tweets
numberOfTweetsintegerOptional
Specify how many tweets you want to collect (20-50000). Our intelligent system automatically handles multiple requests to ensure you get exactly the number you need.
Default value of this property is 20
Max Pages
maxPagesintegerOptional
Maximum number of pages to scrape. Each page typically contains 20 tweets. Set higher for comprehensive data collection. Defaults to calculated value based on numberOfTweets.
Default value of this property is 100
Search Type
searchTypeEnumOptional
Select what you want to search:
'tweets' (default): Universal search for tweets/posts across all users. Uses PostSearchScraper to search tweets globally with advanced filters.
'users': Universal search for X/Twitter user profiles. Uses UserSearchScraper to find users matching your criteria.
'profile': Search tweets within a specific user's profile. Uses ProfileSearchScraper to scrape a user's profile and search their tweets. REQUIRED: When 'profile' is selected, you MUST provide the target username in 'From Users' field (usersFromUsers) - the first entry will be used. You can also use other user filters like 'To Users', 'Mention Users', 'Exclude From Users', and verification filters to further refine the search within that profile.
Value options:
"tweets": string"users": string"profile": string
Default value of this property is "tweets"
Include User Stats
includeUserStatsbooleanOptional
Include detailed profile statistics (followers, following, tweets count, location, website, join date, banner) for users. When searching tweets/posts, includes author stats. When searching users, includes stats for each user found. This requires an additional request per unique user.
Default value of this property is false
Engagement Level Preset
engagementLevelEnumOptional
Smart presets for common engagement scenarios. Choose a preset for instant setup or customize with specific values below for precise control.
Minimum number of retweets (shares). Leave empty for no minimum.
Maximum Retweets
engagementMaxRetweetsintegerOptional
Maximum number of retweets (shares). Leave empty for no maximum.
Minimum Likes
engagementMinLikesintegerOptional
Minimum number of likes (hearts). Leave empty for no minimum.
Maximum Likes
engagementMaxLikesintegerOptional
Maximum number of likes (hearts). Leave empty for no maximum.
Minimum Replies
engagementMinRepliesintegerOptional
Minimum number of replies (comments). Leave empty for no minimum.
Maximum Replies
engagementMaxRepliesintegerOptional
Maximum number of replies (comments). Leave empty for no maximum.
Must Have Any Engagement
engagementHasEngagementbooleanOptional
Only include tweets that have at least some engagement (likes, retweets, or replies)
Media Types
mediaTypesarrayOptional
Types of media to include in search results. Available options:
image: Tweets containing images
video: Tweets containing videos
native_video: Tweets with native Twitter videos
spaces: Tweets from Twitter Spaces (audio conversations)
You can select multiple types. Selecting both 'image' and 'video' will search for any media content.
Has Links
mediaHasLinksbooleanOptional
Must contain links
Has Mentions
mediaHasMentionsbooleanOptional
Must contain mentions
Has Hashtags
mediaHasHashtagsbooleanOptional
Must contain hashtags
News Only
mediaNewsOnlybooleanOptional
Only tweets with news links
Safe Content Only
mediaSafeContentOnlybooleanOptional
Exclude potentially sensitive content
Blue Verified Users Only
usersBlueVerifiedOnlybooleanOptional
Only tweets from blue verified users
Verified Users Only
usersVerifiedOnlybooleanOptional
Only tweets from verified users
From Users
usersFromUsersarrayOptional
Tweets from specific users (without @). REQUIRED for profile search: When searchType is 'profile', provide the target username here (first entry will be used). For other search types, this filters results to tweets from these users.
To Users
usersToUsersarrayOptional
Replies to specific users (without @)
Mention Users
usersMentionUsersarrayOptional
Tweets mentioning specific users (without @)
Exclude From Users
usersExcludeFromUsersarrayOptional
Exclude tweets from specific users (without @)
From List Members
usersListMembersarrayOptional
Tweets from members of specific lists (list ID or username/listname)
Language
contentLanguageEnumOptional
Filter tweets by language. Select the language code for tweets you want to find. Language detection is approximate and may not always be accurate. Works best when combined with other filters.
Filter tweets by emoticon sentiment. Positive: Matches tweets with positive emoticons like :) :-) :P :D. Negative: Matches tweets with negative emoticons like :( :-(. Useful for sentiment analysis and finding emotional content.
Value options:
"positive": string"negative": string
Keywords
contentKeywordsarrayOptional
Search for specific keywords in tweet content. Enter one or more keywords that should appear in tweets. Keywords are matched individually (AND logic). For exact phrase matching, use 'Exact Phrases' instead. Example: ['climate change', 'sustainability'] will find tweets containing both 'climate change' AND 'sustainability'.
Exact Phrases
contentExactPhrasesarrayOptional
Search for exact phrases in tweet content. Phrases are automatically wrapped in quotes for exact matching. Use this when you need to find tweets containing specific word combinations in order. Example: ['breaking news', 'just announced'] will find tweets containing the exact phrase 'breaking news' OR 'just announced'.
Exclude Keywords
contentExcludeKeywordsarrayOptional
Exclude tweets containing specific keywords. Useful for filtering out unwanted content like spam, ads, or promotional material. Example: ['spam', 'ad', 'promotion'] will exclude tweets containing any of these words.
Hashtags
contentHashtagsarrayOptional
Search for tweets containing specific hashtags. Enter hashtags without the # symbol (it's added automatically). You can include multiple hashtags - tweets matching any of them will be included. Example: ['AI', 'MachineLearning'] will find tweets with #AI OR #MachineLearning.
Exclude Hashtags
contentExcludeHashtagsarrayOptional
Exclude tweets containing specific hashtags. Useful for filtering out tweets with unwanted hashtags like promotional tags or spam. Enter hashtags without the # symbol. Example: ['ad', 'sponsored'] will exclude tweets containing #ad OR #sponsored.
Cashtags
contentCashtagsarrayOptional
Search for tweets containing stock symbols (cashtags). Enter stock symbols without the $ symbol (it's added automatically). Useful for tracking stock market discussions and financial content. Example: ['AAPL', 'TSLA'] will find tweets mentioning $AAPL OR $TSLA.
Include Question Marks
contentQuestionMarksbooleanOptional
Only include tweets that contain question marks (?). Useful for finding questions, polls, or tweets seeking information. When enabled, only tweets with question marks will be returned.
Include Tweet Types
tweetTypesarrayOptional
Filter to include specific types of tweets. Select one or more types to narrow your search. Note: If you select multiple types, tweets matching ANY of them will be included. Use 'Exclude Tweet Types' below to filter out unwanted types.
retweet: Old-style retweets (RT) and quoted tweets
nativeretweets: Only native retweets (created with retweet button, works within last 7-10 days)
reply: Tweets that are replies to other tweets (useful for finding conversations)
quote: Quote tweets (tweets that quote another tweet)
self_threads: Self-replies only (tweets that are part of a thread by the same user)
Exclude Tweet Types
tweetTypesExcludearrayOptional
Exclude specific types of tweets from results. Useful for filtering out retweets, replies, or other types you don't want. Works in combination with 'Include Tweet Types' - you can include some types while excluding others.
Available types: retweet, nativeretweets, reply, quote, self_threads
Conversation ID
tweetConversationIdstringOptional
Find all tweets that are part of a specific conversation or thread. Enter the tweet ID (Snowflake ID) of any tweet in the conversation. This will return all direct replies and other replies in that thread. Useful for analyzing entire conversation threads.
Quoted Tweet ID
tweetQuotedTweetIdstringOptional
Find all tweets that quote a specific tweet. Enter the tweet ID (Snowflake ID) of the original tweet. This will return all quote tweets that reference that specific tweet. Useful for tracking how a particular tweet spreads through quotes.
Quoted User ID
tweetQuotedUserIdstringOptional
Find all tweets that quote tweets from a specific user. Enter the numeric user ID (not username) of the user whose tweets are being quoted. This returns all quote tweets that reference any tweet from that user. Note: Requires numeric user ID, not username. Example: '44196397' (Elon Musk's user ID).
Poll Types
tweetPollTypesarrayOptional
Filter to include tweets containing polls. Select the types of polls you want to find. You can select multiple types - tweets matching ANY selected type will be included.
Available poll types:
poll or poll2choice_text_only: 2-choice text polls
poll3choice_text_only: 3-choice text polls
poll4choice_text_only: 4-choice text polls
poll2choice_image: 2-choice image polls
poll3choice_image: 3-choice image polls
poll4choice_image: 4-choice image polls
Since Date
timeSincestringOptional
Start date (YYYY-MM-DD)
Until Date
timeUntilstringOptional
End date (YYYY-MM-DD)
Within Time
timeWithinTimestringOptional
Search within last X time (e.g., '2d', '3h', '5m', '30s')
Maximum number of retry attempts for failed HTTP requests. When a request fails (network error, rate limit, server error, etc.), the scraper will automatically retry up to this many times before giving up. Higher values increase reliability but may slow down scraping. Default is 5 retries. Applies to all search types (tweets, users, profile) and list extraction.
Default value of this property is 5
Use Residential Proxy
useResidentialProxybooleanOptional
Use Apify residential proxy for all requests. Enabled by default for better success rates. Disable only if you have a custom proxy configuration.
Default value of this property is true
Proxy Configuration
proxyConfigurationobjectOptional
Advanced proxy configuration. Leave empty to use default residential proxy settings. Supports apifyProxyGroups (e.g., ['RESIDENTIAL']) or legacy 'groups' format.
Proxy Country Code
proxyCountryCodestringOptional
Optional country code to pin proxy to specific country (e.g., 'US', 'GB', 'DE'). Only works with residential proxy.
Proxy URL (Manual)
proxyUrlstringOptional
Optional manual proxy URL for requests. Format: http://username:password@proxy-server:port. Only used if residential proxy is disabled. Note: Residential proxy is recommended and configured automatically.
