Twitter / X Scraper 🐦 Tweets, Profiles, Search & Hashtags — No API Key

Scrape tweets, user profiles, hashtags and advanced-search results from X (formerly Twitter) — no developer account, no API key, no $100/month X API bill. Paste search queries, handles, or URLs and get clean, structured tweet data with engagement metrics, author details, media, and timestamps. Export to JSON, CSV, Excel, or the API.

The output is drop-in compatible with apidojo's Tweet Scraper (likeCount, retweetCount, author.userName, …) — switch Actors without rewriting a single field in your pipeline.

---

⚡ At a glance

Scrapes	Tweets by search query, by profile/handle, by hashtag, and by direct URL
Engagement	likes, retweets, replies, quotes, views, bookmarks
Author data	username, display name, verified flag, avatar, profile links
Filters	language, date range, min likes/retweets/replies, media-only, verified-only
Output	apidojo-compatible JSON → CSV · Excel · XML · API
API key	❌ Not required
X session	optional — add authToken + ct0 for full-completeness scraping
Proxy	residential-ready (recommended for X)
Advanced search	✅ Full from:, since:, filter:media, min_faves: … syntax

---

🎯 What it does

• ✅ Search scraping — any Twitter advanced-search query: keywords, from:user, #hashtag, filter:media, lang:en, min_faves:100, and more.
• ✅ Profile timelines — newest tweets from any handle, with optional replies/retweets.
• ✅ Hashtag tracking — pass #topic as a search term.
• ✅ Direct URLs — tweet, profile, or search URLs; paste and go.
• ✅ Rich filters — language, start/end date, minimum engagement, media-only, verified-only.
• ✅ apidojo-compatible output — migrate from Tweet Scraper V2 with zero field renaming.

---

🚀 Quick start

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

Click Start, then download the dataset as CSV / JSON / Excel.

More examples

Keyword search in English

{ "searchTerms": ["artificial intelligence"], "tweetLanguage": "en", "sort": "Top" }

Hashtag with media only

{ "searchTerms": ["#AI filter:media"], "onlyImage": true }

A user's tweets between two dates

{ "searchTerms": ["from:elonmusk since:2024-01-01 until:2024-06-01"], "sort": "Latest" }

Profile timeline by handle

{ "twitterHandles": ["nasa", "spacex"], "maxItems": 50, "includeReplies": false }

High-engagement tweets only

{ "searchTerms": ["climate change"], "minimumFavorites": 500, "minimumRetweets": 100 }

Direct URLs

{ "startUrls": ["https://x.com/NASA", "https://x.com/NASA/status/1728108619189874825"] }

💡 Tip: You can test any query on x.com/search first — the scraper fetches what you see there.

---

🍜 Output example (apidojo-compatible)

{
  "type": "tweet",
  "id": "1728108619189874825",
  "url": "https://x.com/elonmusk/status/1728108619189874825",
  "twitterUrl": "https://twitter.com/elonmusk/status/1728108619189874825",
  "text": "More than 10 per human on average",
  "retweetCount": 11311,
  "replyCount": 6526,
  "likeCount": 104121,
  "quoteCount": 2915,
  "viewCount": 8200000,
  "bookmarkCount": 702,
  "createdAt": "Fri Nov 24 17:49:36 +0000 2023",
  "lang": "en",
  "isReply": false,
  "isRetweet": false,
  "isQuote": true,
  "media": ["https://pbs.twimg.com/media/HBUzlGwbcAUboWU.jpg"],
  "author": {
    "type": "user",
    "userName": "elonmusk",
    "name": "Elon Musk",
    "url": "https://x.com/elonmusk",
    "twitterUrl": "https://twitter.com/elonmusk",
    "isVerified": true,
    "profilePicture": "https://pbs.twimg.com/profile_images/.../yRsRRjGO_normal.jpg"
  },
  "source": "graphql-auth"
}

---

🍚 Input parameters

Field	Type	Description
searchTerms	array	Search queries (full advanced-search syntax).
twitterHandles	array	Profile handles (without @) to scrape timelines for.
startUrls	array	Direct X/Twitter tweet, profile, or search URLs.
maxItems	integer	Max tweets to return in total.
sort	Latest | Top	Result ordering.
tweetLanguage	string	ISO 639-1 code (e.g. en).
onlyImage / onlyVideo	boolean	Media-only filters.
onlyVerifiedUsers / onlyQuote	boolean	Author/type filters (applied when metadata is present).
minimumRetweets / minimumFavorites / minimumReplies	integer	Minimum-engagement thresholds.
start / end	date	Date range for search terms (YYYY-MM-DD).
includeReplies / includeRetweets	boolean	Timeline composition for handles.
authToken / csrfToken	string (secret)	Your X auth_token + ct0 cookies — optional, for full-completeness scraping.
proxyConfiguration	object	Proxy settings (residential recommended).

Legacy aliases queries, usernames, urls, maxTweets are still accepted.

---

🔑 Using your X session (optional, for best results)

X heavily restricts logged-out access. Supplying your own session cookies unlocks X's native GraphQL API for the most complete, highest-volume results — and keeps you in control instead of relying on a shared, throttled pool.

1. Log in at x.com in Chrome/Edge (a secondary account is fine).
2. Press F12 → Application tab → Cookies → https://x.com.
3. Copy the value of auth_token → paste into authToken.
4. Copy the value of ct0 → paste into csrfToken.

🔒 Cookies are used only to sign read requests for this run and are never stored or logged. Pair them with a residential proxy (ideally same region as the account) for stability. Without a session, the Actor still works via public endpoints (syndication, mirrors) — just with lower completeness on search.

---

🆚 Why choose this Actor

Feature	🐦 This Actor	apidojo Tweet Scraper V2	Microworlds
No X API key required	✅	✅	✅
Advanced-search syntax	✅	✅	✅
apidojo-compatible output	✅ (drop-in)	n/a	❌
Free users via API	✅	❌ (UI only)	varies
No 50-tweet minimum per query	✅	❌ (min 50)	✅
Single-tweet & small queries	✅	❌	✅
Bring-your-own session	✅	❌	❌
Date / language / engagement filters	✅	✅	✅
Residential-proxy support	✅	✅	✅
Transparent fallback chain	✅	❌	❌

Where this Actor wins: no per-query minimums, works for single tweets and tiny result sets, usable on the free tier via API for testing, and emits the exact field names apidojo users already depend on — so migration is copy-paste.

---

🔗 Integrations & automation

• Google Sheets / Excel — export with one click or schedule a recurring run.
• Make / Zapier / n8n — trigger downstream on new dataset items.
• Apify API — pull the dataset in any language:

$curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?format=csv&clean=true&token=<YOUR_TOKEN>"

---

❓ FAQ

Do I need a Twitter/X API key or developer account? No. This Actor works without the paid X API. Add your own session cookies only if you want maximum completeness on search.

Is there a minimum number of tweets per query? No. Unlike some large-scale-only scrapers, there's no 50-tweet minimum — fetch a single tweet or a handful if that's all you need.

Can I scrape tweets from a specific user? Yes — use twitterHandles: ["nasa"] or a search term like from:nasa.

Can I scrape a hashtag? Yes — pass it as a search term: searchTerms: ["#AI"].

How do I filter by date, language, or engagement? Use start/end, tweetLanguage, and minimumFavorites/minimumRetweets/minimumReplies. You can also embed operators directly in a query: from:nasa since:2024-01-01 min_faves:100.

Why did I get fewer results than expected without cookies? X restricts logged-out search. Add authToken + ct0 and a residential proxy for full-volume scraping. Public endpoints are best-effort.

Is the output compatible with apidojo's Tweet Scraper? Yes — fields like id, url, text, likeCount, retweetCount, replyCount, createdAt, and author.userName match, so most pipelines work unchanged.

Is scraping X legal? Scraping public data is generally permitted in many jurisdictions, but you must comply with X's Terms, GDPR/CCPA, and local laws. Use data responsibly.

---

⚠️ Limitations

• Logged-out search is heavily restricted by X; for reliable, high-volume search add your session + a residential proxy.
• Shadow-banned or filtered tweets may not appear — this is X-side behavior, outside the Actor's control.
• Datacenter IPs are rate-limited fast; use residential proxies for scale.
• X can change its GraphQL/search behavior at any time; the Actor degrades gracefully through a fallback chain (auth GraphQL → syndication → mirrors → search hydration).

---

📨 Support & feedback

Need an extra field or hit an issue? Open it on the Actor page — requests are reviewed quickly. If this saved you time, a short ⭐ review on Apify helps others find it.

Happy scraping! 🚀