🐦 X (Twitter) Scraper — $0.10 / 1,000 tweets

Scrape X (Twitter) into clean, structured JSON — for a third of the usual price. Give it a search query, a username, or tweet links, and get back tidy tweet records with full engagement metrics, media, and author data. No X API key, no developer account, no login — just results.

$0.10 per 1,000 tweets (market rate is ~$0.15–0.40). Pay only for what you keep. Built on X's own endpoints over plain HTTP — no headless browser, so it's fast, cheap, and reliable.

---

⚡ Why this scraper

• 💸 Cheapest on the Store — $0.10 / 1,000 tweets, undercutting the usual $0.15–0.40 rate. No start fee, no per-query fee.
• 🔎 Full X advanced search — every operator works (min_faves:, since:, from:, filter:media, lang:, …). See the table below.
• 📊 Complete engagement data — likes, reposts, replies, quotes, views, and bookmarks on every tweet.
• 🖼️ Media with thumbnails — image, video, and GIF URLs, plus a video poster image so you can preview without downloading.
• 🔁 Retweets expanded — get the original tweet's full text and media, not the truncated RT @… shell.
• 🤖 AI-agent ready — callable as a tool from Claude, ChatGPT, Cursor, and any MCP client (see below).
• 🚀 Fast & lightweight — pure HTTP, no browser, so runs finish quickly.
• 🛡️ Self-healing — X changes its internal endpoints without notice; most scrapers go dark for days when that happens. This one detects the change mid-run, re-syncs itself against live X, and keeps delivering — no waiting for a developer to ship a fix.

---

🎯 What you can use it for

• Market & brand research — track what people say about a product, brand, or ticker in real time.
• AI / LLM training & RAG — feed fresh, structured tweets into your models, retrieval systems, and agents.
• Sentiment & trend monitoring — pull the latest tweets on any topic or hashtag and run your own analysis.
• Finance & alt-data — collect social signal around tickers and events for trading models.
• Lead generation & outreach — find people asking about what you offer.

---

🧭 What you can scrape

Input	What you get
Search — searchTerms	Tweets matching a keyword/hashtag query (full advanced-search syntax)
User timelines — usernames	A user's recent tweets (paginated)
Tweet URLs — tweetUrls	Specific tweets by link (profile links → timelines)
Tweet IDs — tweetIds	Specific tweets by numeric id

Pick one mode per run. Set searchMode to Latest, Top, or Media.

---

🤖 Use with AI agents (MCP)

This Actor is callable by AI agents through the Apify MCP server — no extra setup. Point any MCP-capable client (Claude Desktop, ChatGPT, Cursor, or your own agent) at https://mcp.apify.com and just ask:

"Search X for what people are saying about <topic> and summarize the sentiment."

The agent runs this Actor as a tool and streams back clean, structured tweets.

---

📥 Input examples

Scrape user timelines:

{ "usernames": ["nasa", "esa"], "maxItems": 200, "includeReplies": false }

Search with advanced operators:

{
  "searchTerms": ["artificial intelligence min_faves:100", "#nasa since:2026-01-01"],
  "searchMode": "Latest",
  "maxItems": 500,
  "includeSearchTerms": true
}

Advanced search operators

searchTerms is passed to X exactly as if typed into X's search box, so every X advanced-search operator works — no extra fields needed. Combine them freely:

Goal	Operator	Example
Min engagement	min_faves: min_retweets: min_replies:	climate min_faves:500
Date range	since: until:	nasa since:2026-01-01 until:2026-02-01
By / to / mentioning a user	from: to: @	from:nasa filter:media
Language	lang:	deprem lang:tr
Only media / images / video	filter:media filter:images filter:videos	spacex filter:videos
Verified / Blue only	filter:verified filter:blue_verified	ai filter:blue_verified
Links / news / hashtags	filter:links filter:news filter:hashtags	earnings filter:news
A whole thread	conversation_id:	conversation_id:1750000000000000001
Tweets from a List	list:	list:123456789
Near a place	near: within:	protest near:"Istanbul" within:20km
Exclude a term	-	apple -fruit
Exact phrase	"..."	"artificial general intelligence"

---

📤 Output

One tidy JSON object per tweet:

{
  "id": "2075249100035866880",
  "url": "https://x.com/NASA/status/2075249100035866880",
  "text": "July 12 will mark four years of science from @NASAWebb! …",
  "createdAt": "2026-07-09T16:01:56.000Z",
  "lang": "en",
  "likeCount": 216,
  "retweetCount": 38,
  "replyCount": 45,
  "quoteCount": 3,
  "viewCount": 66671,
  "bookmarkCount": 12,
  "authorUsername": "NASA",
  "authorFollowers": 92161445,
  "authorVerified": true,
  "imageUrls": ["https://pbs.twimg.com/media/…jpg"],
  "hashtags": [],
  "mentions": ["NASAWebb"],
  "isRetweet": false,
  "quotedTweetId": null
}

Video and GIF tweets also carry a poster (cover image) alongside the playback URL in the media array, so you can show a thumbnail without downloading the video. Full field list in src/types.ts.

---

💸 Pricing

Pay per result — $0.10 per 1,000 tweets delivered. Duplicates are removed before you're charged. No start fee, no per-query fee. Cap any run with maxItems.

As an X API alternative: X's official API starts at $200/month for 15,000 tweets (~$13 per 1,000). The same 1,000 tweets here cost $0.10 — with no subscription, no approval process, and full advanced search included.

---

❓ FAQ

Do I need an X API key or account? No. Everything runs on Apify's infrastructure — no key, no login, no developer account.

What data does it collect? Only public tweets — the same posts anyone can see. No private/protected accounts, no DMs.

What format is the output? Flat JSON, exportable to CSV, Excel, JSON, or via the API — ready for spreadsheets, databases, and AI pipelines.

How do I control cost? Set maxItems for a hard cap. You only pay per tweet delivered.

Can I search with filters? Yes — every X advanced-search operator works (see the table above): engagement thresholds, dates, language, media, verified-only, and more.

What happens when X changes its internals? The scraper detects the rejection mid-run, refreshes its configuration from live X automatically, and retries — your run keeps producing data instead of failing. Reliability is monitored 24/7 on top of that.

Can I export tweets to CSV or Excel? Yes — every run's dataset downloads as CSV, Excel, JSON, or XML straight from Apify, or via API into Google Sheets, Python, or your database.

---

Scrapes public data only. Please use responsibly and in line with applicable laws and X's terms.