X-Cavator

---

TL;DR

X-Cavator scrapes X.com at 600+ tweets per minute using an advanced high-speed engine — no browser, no overhead, no fragility. Optionally enrich every tweet with a real-time AI Sentiment Score on a precise -5 to +5 scale powered by Gemini AI.

Quick start:

{
  "searchTerms": ["from:NASA"],
  "sort": "Latest",
  "maxItems": 1000
}

---

Result Type	Price per 1,000 tweets	Event Name (PPE)
Standard Result	$0.30	STANDARD_RESULT
Premium AI Result	$0.50	AI_RESULT

[!TIP] This actor uses Pay-per-event (PPE) pricing. You only pay for what you extract. No fixed monthly costs, no hidden fees.

---

---

🧠 The Feature No One Else Has: AI Sentiment Score

While every other scraper just dumps raw tweets, X-Cavator goes further. Enable the AI mode and every tweet in your dataset gets an automatic Sentiment Score on a precise numeric scale:

Score	Meaning
+5	Extremely Positive 🚀
+3	Positive 😊
0	Neutral 😐
-3	Negative 😤
-5	Extremely Negative 💢

• 50+ languages supported — works on Spanish, Portuguese, English, Arabic, and more.
• Zero scraping slowdown — AI analysis runs in a parallel background queue while the scraper continues extracting.
• Powered by Gemini AI — the same model family behind Google's most advanced products.

This is not a simple "positive/negative" tag. It's a precise emotional signal that unlocks brand monitoring, crisis detection, political sentiment tracking, and competitive intelligence at scale.

Output with AI Enabled

{
  "type": "tweet",
  "id": "1728108619189874825",
  "text": "This product completely changed my workflow, absolutely love it!",
  "sentimentScore": 4,
  "likeCount": 8400,
  "retweetCount": 1230,
  "lang": "en",
  "author": {
    "userName": "techreviewer",
    "followers": 58200,
    "isBlueVerified": true
  }
}

---

⚡ How It Works

X-Cavator is built for high-scale data needs, providing a seamless experience without the need for heavy browser overhead.

• 600+ tweets per minute — Optimized for massive datasets.
• Near-zero RAM — Runs efficiently in any environment.
• Enterprise-grade Stability — Built to handle long-running tasks with maximum uptime.
• Continuous Extraction — Smart management ensures your data keeps flowing without interruptions.

---

🧙 Query Wizard

Don't know Twitter's advanced search syntax? No problem. The Query Wizard in the actor's settings lets you build complex searches through simple dropdowns — no code required.

Or, if you prefer, use raw query strings directly:

from:elonmusk -filter:retweets since:2024-01-01 lang:en

---

📊 Full Feature Comparison

Feature	🏆 X-Cavator	Competitor A	Competitor B
Price per 1,000 tweets	$0.30	$0.40	$1.00
AI Sentiment Score (-5 to +5)	✅	❌	❌
Speed (tweets/min)	600+	~350	~150
Optimized for high speed / Zero lag	✅	❌	❌
Query Wizard	✅	✅	❌
Date Range Filter	✅	✅	✅
Geo-targeting	✅	✅	❌
Language Filter	✅	✅	❌
Verified / Twitter Blue filter	✅	✅	❌
Min. Likes / Retweets / Replies	✅	✅	❌
Profile scraping	✅	✅	✅
Search scraping	✅	✅	✅
Multilingual AI Analysis	✅	❌	❌

---

🎯 Who Is This For?

• Brand Managers tracking public perception, sentiment shifts, and crisis signals in real time.
• Researchers & Academics needing large labeled datasets with emotional context, not just raw text.
• Marketing & Growth Teams identifying influencer sentiment and campaign reception.
• Data Engineers building pipelines that require structured, high-volume, pre-enriched social data.
• Competitive Intelligence Analysts monitoring what people really think about your competitors.
• Political & Social Analysts studying discourse and sentiment at a population scale.

---

📥 Input Parameters

Field	Type	Description	Default
searchTerms	array	Keywords, hashtags, or full advanced search queries	[]
twitterHandles	array	Profiles to scrape (no @ needed)	[]
maxItems	number	Max tweets to extract across all queries	100
sort	string	Latest (chronological) or Top (viral)	Latest
tweetLanguage	string	ISO 639-1 language code to filter results	all
startDate	string	Only get tweets after this date	null
endDate	string	Only get tweets before this date	null
onlyVerifiedUsers	boolean	Restrict to verified accounts only	false
onlyTwitterBlue	boolean	Restrict to Twitter Blue subscribers	false
onlyImage	boolean	Only tweets with images	false
onlyVideo	boolean	Only tweets with video	false
onlyQuote	boolean	Only quote tweets	false
tweetAuthor	string	Filter by a specific author handle	null
mentioning	string	Only tweets mentioning this handle	null
inReplyTo	string	Only replies to this handle	null
minimumFavorites	number	Min. likes threshold	null
minimumRetweets	number	Min. retweets threshold	null
minimumReplies	number	Min. replies threshold	null
geotaggedNear	string	Location name (e.g. "New York, NY")	null
withinRadius	string	Radius for geo filter (e.g. "15mi")	null
geocode	string	Strict geo via lat,long,radius	null
enablePremiumAi	boolean	🧠 Enable AI Sentiment Score per tweet	false

---

🧪 Usage Examples

Scrape a profile:

{ "twitterHandles": ["NASA"], "maxItems": 500 }

Search with date range:

{
  "searchTerms": ["artificial intelligence since:2024-01-01 until:2024-12-31"],
  "sort": "Top",
  "maxItems": 2000
}

Brand sentiment monitoring (AI enabled):

{
  "searchTerms": ["Tesla", "@Tesla"],
  "sort": "Latest",
  "maxItems": 5000,
  "enablePremiumAi": true
}

Geo-targeted research:

{
  "searchTerms": ["elections"],
  "geotaggedNear": "Bogotá, Colombia",
  "withinRadius": "50km",
  "tweetLanguage": "es"
}

Viral English-language AI news:

{
  "searchTerms": ["#AI filter:verified"],
  "sort": "Top",
  "tweetLanguage": "en",
  "minimumFavorites": 500
}

---

📤 Output Schema

{
  "type": "tweet",
  "id": "1728108619189874825",
  "url": "https://x.com/elonmusk/status/1728108619189874825",
  "text": "More than 10 per human on average",
  "sentimentScore": -1,
  "likeCount": 104121,
  "retweetCount": 11311,
  "replyCount": 6526,
  "quoteCount": 2915,
  "bookmarkCount": 702,
  "lang": "en",
  "createdAt": "Fri Nov 24 17:49:36 +0000 2023",
  "isReply": false,
  "isRetweet": false,
  "isQuote": true,
  "author": {
    "userName": "elonmusk",
    "name": "Elon Musk",
    "followers": 172669889,
    "isVerified": true,
    "isBlueVerified": true,
    "profilePicture": "https://pbs.twimg.com/profile_images/..."
  }
}

sentimentScore is only present when AI Premium mode is enabled.

---

🔧 Troubleshooting

Problem	Solution
Getting 0 results	Check if your query is too restrictive. Test it on twitter.com/search first.
Fewer results than expected	Try "sort": "Top" instead of "Latest". Some periods have lower search coverage.
AI not running	Make sure enablePremiumAi is set to true in the input.
Missing tweets	X may shadow-ban certain accounts. This is outside our control — try different date ranges.

---

⚖️ Ethical Use

X-Cavator only extracts publicly available data. It does not access DMs, emails, private accounts, or any data not visible on the public timeline. Users are responsible for complying with GDPR, CCPA, and applicable data protection laws when handling datasets containing public PII.

---