AS
Apify Store
/api-ninja/x-twitter-advanced-search
X (Twitter) Advanced Search Scraper 𝕏
Advanced X (Twitter) post search with 50+ filters: content, users, geo, time, engagement, media. Dual modes: simple queries or structured filters. Enterprise-grade reliability for precise data extract
liveasyncunknown~30s typical
social mediaautomationintegrationstwitteradvancedsearch
$0.019
per result + $0.005 call
plus $0.001 platform fee per run
Actor charges $0.015 per result; Cracked adds 25% plus a $0.005 call fee
Bring your own Apify Store key: provider portion drops to $0.
$Set up https://cracked-ai-pearl.vercel.app/SKILL.md, then use Cracked to run apify /api-ninja/x-twitter-advanced-search for me.
Input
| Field | Type | Description |
|---|---|---|
| query | string | Enter your search terms here for quick and easy X (Twitter) searches. Supports X (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. |
| search_type | string (Latest | Top | Media | People | Lists) | Choose your search strategy: 'Latest' for real-time results, 'Top' for popular tweets, 'Media' for tweets with images/videos, or 'People' for user accounts. default "Latest" |
| numberOfTweets | integer | Specify how many tweets you want to collect (minimum 20, no maximum limit). Our intelligent system automatically handles multiple requests to ensure you get exactly the number you need. default 100 |
| scrapeAll | boolean | When enabled, scrapes all available tweets from your input query, ignoring the 'Number of Tweets' limit. This may significantly increase scraping time and resource usage. default false |
| engagementLevel | string (none | low | medium | high | viral) | Smart presets for common engagement scenarios. Choose a preset for instant setup or customize with specific values below for precise control. default "none" |
| engagementMinRetweets | integer | Minimum number of retweets (shares). Leave empty for no minimum. |
| engagementMaxRetweets | integer | Maximum number of retweets (shares). Leave empty for no maximum. |
| engagementMinLikes | integer | Minimum number of likes (hearts). Leave empty for no minimum. |
| engagementMaxLikes | integer | Maximum number of likes (hearts). Leave empty for no maximum. |
| engagementMinReplies | integer | Minimum number of replies (comments). Leave empty for no minimum. |
| engagementMaxReplies | integer | Maximum number of replies (comments). Leave empty for no maximum. |
| engagementHasEngagement | boolean | Only include tweets that have at least some engagement (likes, retweets, or replies) |
| mediaTypes | array | Filter tweets by content type. Choose from images, videos, or any media attachments. |
| mediaHasLinks | boolean | Must contain links |
| mediaHasMentions | boolean | Must contain mentions |
| mediaHasHashtags | boolean | Must contain hashtags |
| mediaNewsOnly | boolean | Only tweets with news links |
| mediaSafeContentOnly | boolean | Exclude potentially sensitive content |
| usersBlueVerifiedOnly | boolean | Only tweets from blue verified users |
| usersVerifiedOnly | boolean | Only tweets from verified users |
| usersFromUsers | array | Tweets from specific users (without @) |
| usersToUsers | array | Replies to specific users (without @) |
| usersMentionUsers | array | Tweets mentioning specific users (without @) |
| usersExcludeFromUsers | array | Exclude tweets from specific users (without @) |
| usersListMembers | array | Tweets from members of specific lists (list ID or username/listname) |
| contentLanguage | string (en | es | fr | de | it | pt) | Filter tweets by language. Uses automatic language detection for accurate results. |
| contentEmoticons | string (positive | negative) | Filter tweets based on emotional tone detected from emojis and emoticons.t |
| contentKeywords | array | Keywords to search for in tweet content |
| contentExactPhrases | array | Exact phrases to search for (use quotes) |
| contentExcludeKeywords | array | Keywords to exclude from results |
| contentHashtags | array | Hashtags to include (without #) |
| contentExcludeHashtags | array | Hashtags to exclude (without #) |
| contentCashtags | array | Stock symbols to include (without $) |
| contentQuestionMarks | boolean | Include tweets with question marks |
| tweetTypes | array | Types of tweets to include |
| tweetTypesExclude | array | Types of tweets to exclude |
| tweetConversationId | string | Tweets that are part of a specific conversation/thread |
| tweetQuotedTweetId | string | Tweets that quote a specific tweet |
| tweetQuotedUserId | string | Tweets that quote a specific user (numeric user ID) |
| tweetPollTypes | array | Tweets containing polls |
Call it
curl
curl https://cracked-ai-pearl.vercel.app/v1/run \
-H "Authorization: Bearer ck_live_..." -H "content-type: application/json" \
-d '{"provider":"apify","endpoint":"/api-ninja/x-twitter-advanced-search","input":{"query":"Tweet or treat?..."},"wait":false}'poll
curl "https://cracked-ai-pearl.vercel.app/v1/runs/<runId>?wait=30" -H "Authorization: Bearer ck_live_..."cli
npx cracked-ai run -p apify -e /api-ninja/x-twitter-advanced-search -i '{"query":"Tweet or treat?..."}' -w 120mcp
run_tool({ provider: "apify", endpoint: "/api-ninja/x-twitter-advanced-search", input: {"query":"Tweet or treat?..."}, wait: false })Try it
Runs against your signed-in workspace balance. Sign in if you have not.