🚀 X (Twitter) Advanced Search Actor The most powerful and flexible Twitter search solution for Apify - Unlock the full potential of X (formerly Twitter) data collection with our sophisticated search capabilities and advanced filtering system. ## 🌟 What Makes Us Superior? Our X (Twitter) Advanced Search Actor represents the pinnacle of social media data extraction technology. Unlike basic scrapers that offer limited functionality, we provide: ### 🎯 Dual Search Modes for Maximum Flexibility - Simple Query Mode: Use traditional X search syntax for quick, straightforward searches - Advanced Filter Mode: Leverage our revolutionary structured filter system for precise, complex data collection ### 🔍 Industry-Leading Filter System Our proprietary filtering technology offers 8 comprehensive filter categories with 50+ individual filter options: - Content Filters: Keywords, exact phrases, hashtags, cashtags, language detection, emoticons, and more - User Filters: Verified users, blue checkmarks, specific accounts, mentions, and user lists - Geographic Filters: Location-based searches with radius controls and place IDs - Time Filters: Date ranges, Unix timestamps, relative time windows, and tweet ID boundaries - Engagement Filters: Like, retweet, and reply thresholds with smart presets - Media Filters: Images, videos, links, news content, and safe content filtering - Tweet Type Filters: Original tweets, retweets, quotes, replies, and conversation threads - App/Source Filters: Platform-specific searches and card content filtering ### ⚡ Advanced Features That Set Us Apart - 🧠 Intelligent Query Optimization: Automatic query refinement for better performance and results - 🛡️ Robust Input Validation: Comprehensive validation prevents invalid filter combinations - 📊 Smart Engagement Presets: Quick access to viral, trending, and engagement-based filters - 🔄 Seamless Pagination: Automatic handling of large datasets with cursor-based navigation - 📈 Flexible Query Types: Choose between "Latest" (real-time) or "Top" (popular) results - 🎨 Structured Data Output: Clean, consistent JSON format for easy analysis and integration ## 🚀 Why Choose Our X (Twitter) Advanced Search Actor? ### Unmatched Precision Our advanced filter system allows you to target exactly the content you need, reducing noise and improving data quality by up to 90%. ### Enterprise-Grade Reliability Built with scalability and reliability in mind, our actor handles millions of tweets with consistent performance and comprehensive error handling. ### Developer-Friendly Clean APIs, detailed documentation, and extensive examples make integration seamless for developers of all skill levels. ### Future-Proof Technology Our modular architecture adapts to X's evolving platform, ensuring your data collection remains uninterrupted. ## 📖 How to Use X (Twitter) Advanced Search ### Step 1: Set Up Your API Key Configure your API credentials in your Apify account environment variables. ### Step 2: Choose Your Search Method #### Method A: Simple Query (Quick & Easy) json { "query": "artificial intelligence OR AI from:elonmusk since:2024-01-01", "queryType": "Latest", "numberOfTweets": 100 } #### Method B: Advanced Filters (Maximum Precision) json { "advancedFilters": { "content": { "keywords": ["machine learning", "AI"], "hashtags": ["AI", "MachineLearning"], "language": "en", "excludeKeywords": ["spam", "bot"] }, "users": { "verifiedOnly": true, "fromUsers": ["elonmusk", "tim_cook"] }, "engagement": { "minLikes": 100, "minRetweets": 10 }, "time": { "withinTime": "24h" } }, "queryType": "Top", "numberOfTweets": 200 } ### Step 3: Execute and Collect Run the actor and access your structured data in multiple formats (JSON, CSV, Excel). ## 🔧 X (Twitter) Advanced Search Syntax Reference Our actor supports the complete range of X's advanced search operators. Here's your comprehensive reference: ### Content Operators | Operator | Description | Example | |----------|-------------|---------| | "exact phrase" | Search for exact phrases | "machine learning" | | keyword1 keyword2 | Both keywords (implicit AND) | AI technology | | keyword1 OR keyword2 | Either keyword | AI OR artificial intelligence | | +forced_term | Force inclusion (prevent spelling correction) | +radiooooo | | -excluded_term | Exclude terms | AI -spam | | #hashtag | Hashtag search | #AI | | $cashtag | Stock symbol search | $TSLA | | ? | Questions only | What ? | | :) or :( | Positive/negative emoticons | :) OR :( | | url:domain.com | URL content search | url:github.com | | lang:en | Language filter | lang:en | ### User Operators | Operator | Description | Example | |----------|-------------|---------| | from:username | Tweets from specific user | from:elonmusk | | to:username | Replies to specific user | to:support | | @username | Mentions of specific user | @company_handle | | list:list_id | Tweets from list members | list:715919216927322112 | | filter:verified | Verified users only | filter:verified | | filter:blue_verified | Blue checkmark users | filter:blue_verified | ### Geographic Operators | Operator | Description | Example | |----------|-------------|---------| | near:"city" | Geotagged in location | near:"San Francisco" | | within:radius | Within radius of location | within:10km | | geocode:lat,long,radius | Precise coordinates | geocode:37.7764685,-122.4172004,10km | | place:place_id | Specific place ID | place:96683cc9126741d1 | ### Time Operators | Operator | Description | Example | |----------|-------------|---------| | since:2024-01-01 | From date (inclusive) | since:2024-01-01 | | until:2024-12-31 | Before date (exclusive) | until:2024-12-31 | | since_time:timestamp | Unix timestamp from | since_time:1640995200 | | until_time:timestamp | Unix timestamp until | until_time:1672531199 | | within_time:2d | Relative time window | within_time:24h | ### Engagement Operators | Operator | Description | Example | |----------|-------------|---------| | min_retweets:5 | Minimum retweets | min_retweets:100 | | min_faves:10 | Minimum likes | min_faves:1000 | | min_replies:100 | Minimum replies | min_replies:50 | | filter:has_engagement | Has any engagement | filter:has_engagement | ### Media Operators | Operator | Description | Example | |----------|-------------|---------| | filter:media | All media types | filter:media | | filter:images | Images only | filter:images | | filter:videos | Videos only | filter:videos | | filter:links | Contains links | filter:links | | filter:news | News content | filter:news | ### Tweet Type Operators | Operator | Description | Example | |----------|-------------|---------| | filter:retweets | Retweets and quotes | filter:retweets | | filter:replies | Reply tweets | filter:replies | | filter:quote | Quote tweets | filter:quote | | conversation_id:id | Conversation thread | conversation_id:1140437409710116865 | For the complete reference, visit: Twitter Advanced Search Operators ## 📊 Advanced Filter System Deep Dive ### Content Filters json { "content": { "keywords": ["artificial intelligence", "AI"], "exactPhrases": ["\"machine learning algorithms\""], "excludeKeywords": ["spam", "bot"], "hashtags": ["AI", "MachineLearning"], "excludeHashtags": ["spam"], "cashtags": ["TSLA", "AAPL"], "urls": ["github.com", "stackoverflow.com"], "language": "en", "questionMarks": true, "emoticons": "positive", "emojis": ["🚀", "💡"], "wildcardPhrases": ["\"this is the * time this week\""] } } ### User Filters json { "users": { "fromUsers": ["elonmusk", "tim_cook"], "toUsers": ["support"], "mentionUsers": ["company_handle"], "excludeFromUsers": ["spam_account"], "lists": ["715919216927322112"], "verifiedOnly": true, "blueVerifiedOnly": false, "followsOnly": false, "socialNetworkOnly": false, "trustedOnly": false } } ### Geographic Filters json { "geo": { "near": "San Francisco", "withinRadius": "25km", "geocode": "37.7764685,-122.4172004,10km", "placeId": "96683cc9126741d1" } } ### Time Filters json { "time": { "since": "2024-01-01", "until": "2024-12-31", "sinceTime": 1640995200, "untilTime": 1672531199, "sinceId": "1138872932887924737", "maxId": "1144730280353247233", "withinTime": "24h" } } ### Engagement Filters with Smart Presets json { "engagementLevel": "high", // low, medium, high, viral "engagementMinRetweets": 10, "engagementMinLikes": 100, "engagementMaxRetweets": 50, "engagementMaxLikes": 1000, "engagementMinReplies": 5, "engagementMaxReplies": 100, "engagementHasEngagement": true } Quick Presets: - Low: 1-10 likes, 0-2 retweets - Medium: 10-100 likes, 2-10 retweets - High: 100-1000 likes, 10-50 retweets - Viral: 1000+ likes, 50+ retweets ### Media Filters json { "media": { "mediaTypes": ["images", "videos"], "excludeMediaTypes": ["vine"], "hasLinks": true, "hasMentions": false, "hasHashtags": true, "newsOnly": false, "safeContentOnly": true } } ### Tweet Type Filters json { "tweetTypes": { "tweetTypes": ["original", "quotes"], "excludeTweetTypes": ["retweets", "replies"], "conversationId": "1140437409710116865", "quotedTweetId": "1138631847783608321", "quotedUserId": "11348282", "includeNativeRetweets": false } } ### App/Source Filters json { "apps": { "sources": ["twitter_for_iphone", "tweetdeck"], "excludeSources": ["spam_app"], "cardDomains": ["youtube.com", "github.com"], "cardUrls": ["youtube.com/watch"], "cardNames": ["player", "summary"] } } ## 🎯 Pre-Built Filter Presets ### Viral Content json { "advancedFilters": { "engagement": { "minLikes": 1000, "minRetweets": 100 } } } ### News Content json { "advancedFilters": { "media": { "newsOnly": true, "hasLinks": true }, "content": { "language": "en" } } } ### Verified Users Only json { "advancedFilters": { "users": { "verifiedOnly": true } } } ### Recent Tweets (24 hours) json { "advancedFilters": { "time": { "withinTime": "24h" } } } ### Local News json { "advancedFilters": { "geo": { "near": "New York", "withinRadius": "50km" }, "media": { "newsOnly": true } } } ## 📈 Output Data Structure Our actor returns comprehensive, structured data for each tweet: json { "type": "tweet", "id": "1781234567890123456", "url": "https://twitter.com/elonmusk/status/1781234567890123456", "text": "Exciting developments in AI and machine learning!", "source": "Twitter for iPhone", "retweetCount": 1234, "replyCount": 567, "likeCount": 8901, "quoteCount": 234, "viewCount": 45678, "createdAt": "Tue Dec 10 07:00:30 +0000 2024", "lang": "en", "bookmarkCount": 89, "isReply": false, "author": { "type": "user", "userName": "elonmusk", "url": "https://twitter.com/elonmusk", "id": "44196397", "name": "Elon Musk", "isBlueVerified": true, "verifiedType": "Blue", "profilePicture": "https://pbs.twimg.com/profile_images/...", "description": "CEO of Tesla and SpaceX", "location": "Austin, Texas", "followers": 150000000, "following": 500, "createdAt": "Tue Jun 02 20:12:29 +0000 2009" }, "entities": { "hashtags": [ { "indices": [25, 35], "text": "AI" } ], "urls": [], "user_mentions": [] } } ## 🛡️ Legal and Ethical Considerations Our actor operates within ethical boundaries and legal frameworks: - Public Data Only: We only collect publicly available information that users have chosen to share - No Private Data: We do not access private accounts, direct messages, or personal information - GDPR Compliant: Our data collection respects privacy regulations and user consent - Rate Limiting: Built-in safeguards prevent excessive API usage - Transparent Operations: Clear documentation of what data is collected and how it's used For detailed information about web scraping legality, please refer to our comprehensive guide. ## 💡 Pro Tips for Maximum Results ### 🎯 Optimization Strategies - Start Specific: Begin with targeted filters and expand as needed - Combine Filters: Use multiple filter types for precise results - Test Iteratively: Experiment with different combinations to find optimal settings - Monitor Performance: Track query performance and adjust accordingly ### 🔧 Advanced Techniques - Use Engagement Presets: Leverage our smart presets for common use cases - Time-Based Filtering: Combine date ranges with engagement filters for trending content - Geographic Targeting: Use location filters for local market research - Content Analysis: Combine language and sentiment filters for brand monitoring ### 📊 Best Practices - Validate Inputs: Our actor validates all filter combinations automatically - Handle Pagination: Use cursor-based pagination for large datasets - Monitor Rate Limits: Be aware of API limitations for high-volume operations - Data Quality: Use exclusion filters to improve result relevance ## 🚀 Getting Started 1. Set up your API credentials in your Apify account 2. Choose your search method (Simple Query or Advanced Filters) 3. Configure your parameters using our comprehensive filter system 4. Execute the actor and collect your structured data 5. Analyze and integrate your results using multiple export formats ## 📞 Support and Documentation - Comprehensive Examples: Extensive code samples and use cases - Filter Documentation: Detailed explanations of all filter options - API Reference: Complete technical documentation - Community Support: Active community and expert assistance --- Ready to unlock the full potential of X (Twitter) data? Start with our advanced search capabilities and experience the difference that superior technology makes. Transform your social media intelligence with the most powerful X (Twitter) search solution available.