🐦 X (Twitter) Tweet Scraper — All-in-One | No Login | Search, Hashtags & Profiles

Extract tweets from X.com (Twitter) using search queries, hashtags, usernames, direct URLs, or brand mentions — all in one actor. Returns tweet text, engagement metrics, author profiles, media URLs, and more. No API key, no login, no cookies required.

Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools.

---

What This Actor Does

This actor hits X's internal search API to collect structured tweet data across four input modes. Give it a keyword, a hashtag, a list of @handles, a direct X.com URL, or a brand handle to monitor — and get back clean, consistent, AI-ready JSON. All filters are implemented as X's own advanced search operators for maximum compatibility.

Ideal for: social media researchers, marketers, B2B analysts, brand monitoring teams, LLM/AI pipeline builders, journalists, and data scientists who need fresh tweet data without the Twitter API's tier restrictions.

---

Key Features

• 5 input modes in one actor — search queries, hashtags, usernames, direct URLs, and brand/user mention monitoring. Most competitors force you to pick one.
• Sort by Top or Latest — switch between most-engaged tweets (Top) or most-recent (Latest), or run Both for maximum coverage.
• Engagement filters — set minimum likes, retweets, or replies to only get high-value tweets.
• Content type filters — only images, only videos, only verified accounts.
• Brand mention monitoring — use the mentioning field to find all tweets mentioning @YourBrand.
• No login or API key required — works out of the box using X's public API layer.
• Source query tagging — optionally tag each tweet with which query found it, so multi-query runs stay traceable.
• Full MCP/AI agent metadata — semantic field names, complete dataset schema, rich output schema descriptions. The only X scraper optimized for Claude, ChatGPT, and AI pipelines.
• Deduplication built-in — same tweet won't appear twice, even across overlapping queries.
• scraped_at timestamp — every record includes when it was scraped, not just when it was posted.

---

Use Cases

Brand Monitoring — Use mentioning: "YourBrand" to track every tweet that tags you. Combine with minimumLikes: 50 to surface only the ones getting traction.

Top Content Research — Set sort: "Top" and minimumLikes: 100 on a hashtag to collect the most viral tweets in your niche. Perfect for content strategy and inspiration.

Competitor Analysis — Scrape a competitor's handle with handles: ["CompetitorX"], exclude retweets, and analyze their best-performing original content.

Lead Generation — Search for tweets describing a problem your product solves (e.g. "anyone know a tool for email verification"), collect the author handles, and build an outreach list.

Trend Tracking — Monitor hashtags over time with date range filters. Run daily via Apify's scheduler to build a time-series of tweet volume and engagement.

AI Training Data — Collect large, language-filtered, engagement-filtered tweet datasets for fine-tuning sentiment classifiers, topic models, or dialogue systems.

News & Event Analysis — Combine sort: "Latest" with date range filters to capture real-time reaction to an announcement or event as it unfolds.

---

Input Parameters

Core Input Modes

Parameter	Description
searchQuery	Keywords or X advanced search syntax (e.g. "AI tools" lang:en)
hashtags	Array of hashtags to scrape (["AI", "ChatGPT"])
handles	Array of @usernames to scrape timelines from
startUrls	Direct X.com profile or search URLs
mentioning	Find all tweets that mention this username (brand monitoring)

Sort & Volume

Parameter	Default	Description
sort	Latest	Latest (chronological), Top (most-engaged), or Both
maxTweetsPerQuery	50	Max tweets per query/handle/hashtag

Filters

Parameter	Default	Description
lang	(all)	ISO 639-1 language code (en, es, fr, de, ja…)
startDate	(none)	Collect tweets since this date (YYYY-MM-DD)
endDate	(none)	Collect tweets until this date (YYYY-MM-DD)
minimumLikes	0	Only tweets with at least N likes
minimumRetweets	0	Only tweets with at least N retweets
minimumReplies	0	Only tweets with at least N replies
onlyVerified	false	Only tweets from verified accounts
onlyImages	false	Only tweets containing images
onlyVideos	false	Only tweets containing videos
excludeReplies	false	Skip reply tweets
excludeRetweets	false	Skip retweets

Output Options

Parameter	Default	Description
includeSourceQuery	false	Add source_query field to each tweet showing which query found it

---

Output Format

Each record represents one tweet:

{
  "tweet_id": "1773456789012345678",
  "text": "Just launched our new AI product! 🚀 #AI #tech",
  "full_text": "Just launched our new AI product! 🚀 #AI #tech https://t.co/example",
  "author_handle": "openai",
  "author_name": "OpenAI",
  "author_id": "1288285673",
  "author_followers": 2500000,
  "author_following": 342,
  "author_verified": true,
  "created_at": "Mon Mar 25 14:30:00 +0000 2024",
  "like_count": 4200,
  "retweet_count": 1100,
  "reply_count": 830,
  "quote_count": 210,
  "view_count": 980000,
  "is_reply": false,
  "is_retweet": false,
  "is_quote": false,
  "has_media": true,
  "media_urls": ["https://pbs.twimg.com/media/example.jpg"],
  "hashtags": ["AI", "tech"],
  "urls": ["https://openai.com/blog/example"],
  "lang": "en",
  "conversation_id": "1773456789012345678",
  "in_reply_to_user": null,
  "url": "https://x.com/openai/status/1773456789012345678",
  "source_url": "https://twitter.com/i/api/2/search/adaptive.json?q=AI",
  "scraped_at": "2026-03-31T12:00:00.000Z"
}

Export formats: JSON, CSV, XLSX, XML.

---

Example Inputs

Find top viral AI tweets

{
  "searchQuery": "artificial intelligence",
  "sort": "Top",
  "minimumLikes": 100,
  "lang": "en",
  "maxTweetsPerQuery": 200
}

Monitor brand mentions

{
  "mentioning": "YourBrand",
  "sort": "Latest",
  "excludeRetweets": true,
  "maxTweetsPerQuery": 500
}

Scrape a profile timeline

{
  "handles": ["elonmusk", "sama", "karpathy"],
  "excludeReplies": true,
  "excludeRetweets": true,
  "maxTweetsPerQuery": 200
}

Date-bounded event capture

{
  "hashtags": ["GPT4", "OpenAI"],
  "startDate": "2024-03-01",
  "endDate": "2024-03-15",
  "sort": "Both",
  "maxTweetsPerQuery": 1000
}

Multi-query with source tagging

{
  "searchQuery": "AI scraping tools",
  "hashtags": ["WebScraping"],
  "handles": ["apify"],
  "includeSourceQuery": true,
  "maxTweetsPerQuery": 100
}

---

Pricing

Pay-Per-Result — you only pay for tweets actually scraped.

Volume	Price per 1,000 tweets
Any volume	$0.25 / 1,000 tweets

Example costs:

• 1,000 tweets → $0.25
• 10,000 tweets → $2.50
• 100,000 tweets → $25.00

37.5% cheaper than the market leader at equivalent quality. No monthly subscription, no hidden fees.

---

Running via API

curl -X POST \
  "https://api.apify.com/v2/acts/USERNAME~x-tweet-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "searchQuery": "artificial intelligence",
    "sort": "Top",
    "minimumLikes": 50,
    "lang": "en",
    "maxTweetsPerQuery": 100,
    "excludeRetweets": true
  }'

---

Limitations

• X rate-limits unauthenticated search requests. Polite delays are applied between pages. Very large single-query jobs (5,000+ tweets) work better split into smaller date-bounded runs.
• view_count is not available for all tweets — this field may be null.
• X periodically changes their internal API structure. We commit to pushing fixes within 48 hours of any breaking change.
• Only publicly accessible tweets are scraped. Protected (private) accounts are not reachable.
• The sort: "Both" mode may return a small number of duplicate tweet IDs — these are deduplicated automatically in the output.

---

Works Great With

• Apify Scheduler — run on autopilot for continuous brand monitoring or trend tracking
• Google Sheets Integration — export results directly to spreadsheets via Apify's built-in integrations
• Webhook trigger — pipe results to your own endpoint or Zapier workflow

---

Support

Found a bug or want a feature? Open an issue on this actor's page. We respond within 48 hours.

If this actor saves you time, leaving a ⭐ review helps others find it and helps us keep it maintained and up to date!

---

Changelog

v1.0.0 — Initial release. Supports search queries, hashtags, handles, startUrls, and brand mention monitoring. Sort by Top/Latest/Both. Engagement filters (minLikes, minRetweets, minReplies). Content type filters (images, videos, verified). Full MCP dataset schema. PAY_PER_EVENT at $0.25/1K tweets.