Twitter Scraper - Scrape Tweets from X Profiles

---

📌 Overview

The X (Twitter) Tweet Scraper collects tweets from any list of X / Twitter @handles or profile URLs and returns each tweet with complete metadata: likes, retweets, replies, quotes, bookmarks and views, plus hashtags, mentions, links, media, language and the post date. It paginates each timeline to pull hundreds of tweets per profile.

It needs no login, no cookies and no API key — it reads only public data through residential proxies, so there's zero risk to any X account. With no headless browser, it's a fast and low-cost way to build large tweet datasets.

✅ Add many handles and raise maxTweetsPerProfile to assemble an analysis-ready tweet dataset in a single run.

---

✨ Features

	Feature	Description
📦	Hundreds per profile	Cursor pagination walks the full public timeline.
📊	Every engagement metric	Likes, retweets, replies, quotes, bookmarks & views.
🧵	Rich tweet data	Hashtags, mentions, links, media, language & flags (reply / quote / retweet).
👤	Author context	Username, name, follower count and verified status per tweet.
🎚️	Smart filters	Toggle retweets and replies in or out.
⚡	No browser	Lightweight API access — fast and cheap at scale.
🛡️	Login-free & safe	Guest-token access over residential proxies — no account, no ban risk.
📤	Any format	Export to JSON, CSV, Excel, HTML or pull via API & webhooks.

---

🎯 Who it's for

• Content & competitor analysis — see which posts and formats win in your niche.
• Brand & executive monitoring — archive an account's output with engagement.
• Data science & ML — build labelled tweet datasets for NLP, sentiment & trends.
• Marketers & analysts — benchmark reach and engagement across accounts and time.

---

🧾 Input

Field	Type	Description
profiles	array	Required. X @handles or profile URLs (nasa, @naval, https://x.com/stripe).
maxTweetsPerProfile	integer	How many tweets to collect per profile (paginated). Default 100.
includeRetweets	boolean	Include the profile's retweets. Default true.
includeReplies	boolean	Include the profile's replies. Default true.
maxResults	integer	Global cap on tweets saved. 0 = unlimited.
proxyConfiguration	object	Residential proxy (required by X). Pre-configured for you.

Example input

{
  "profiles": ["nasa", "naval"],
  "maxTweetsPerProfile": 200,
  "includeReplies": false
}

---

📦 Output

Each tweet is saved as one structured record:

{
  "tweetId": "2059393717111308634",
  "url": "https://x.com/NASA/status/2059393717111308634",
  "text": "On Tuesday, June 9, we'll announce the four astronauts who will...",
  "createdAt": "Tue Jun 03 16:00:00 +0000 2026",
  "lang": "en",
  "likeCount": 38146,
  "retweetCount": 4120,
  "replyCount": 612,
  "quoteCount": 210,
  "bookmarkCount": 1503,
  "viewCount": 2834957,
  "isReply": false,
  "isQuote": false,
  "isRetweet": false,
  "hashtags": ["Artemis"],
  "mentions": ["NASA_Astronauts"],
  "urls": ["https://www.nasa.gov/..."],
  "media": [{ "type": "photo", "url": "https://pbs.twimg.com/media/..." }],
  "author": { "username": "NASA", "name": "NASA", "followers": 92089565, "verified": true },
  "fromProfile": "NASA"
}

📖 Output field reference

Field	Description
text	Full tweet text (long-form posts supported)
likeCount / retweetCount / replyCount	Core engagement
quoteCount / bookmarkCount / viewCount	Extended engagement & reach
isReply / isQuote / isRetweet	Tweet type flags
hashtags / mentions / urls	Entities extracted from the tweet
media	Photos / videos with type and URL
author	Tweet author with follower count & verified status
createdAt / url	Post date and direct link

---

⚙️ How it works

1. You provide X @handles or profile URLs.
2. The actor resolves each profile and walks its public timeline with cursor pagination.
3. Each tweet is parsed into a clean record with full engagement metrics.
4. Your retweet / reply filters are applied and results stream to the dataset.

No login, no cookies, no API keys — and no X account is ever used or risked.

---

❓ FAQ

Is this an X / Twitter API alternative?

Yes. It pulls a profile's tweets with full engagement without the official X / Twitter API, a developer account, app keys or the API's low free-tier read caps — just paste handles and run.

Does it need login or cookies?

No. The Actor uses public guest-token access — no login, no cookies you provide and no developer API key. No X account is involved, so there's zero ban risk.

How many tweets can I get per profile?

Hundreds — it paginates the public timeline with cursor pagination and you control depth with maxTweetsPerProfile. Run many handles in one go for a large dataset.

Are view counts included?

Yes — the view count is captured whenever X exposes it, alongside likes, retweets, replies, quotes and bookmarks.

Can I exclude retweets or replies?

Yes — toggle includeRetweets and includeReplies independently to get only the original tweets you want.

Can I scrape tweets without an API key or login?

Yes. This is a Twitter scraper without API key — it uses public guest-token access over residential proxies, so you scrape tweets without login, cookies or a developer account, and with zero ban risk.

How do I export tweets to CSV or JSON?

Every run builds a tweet dataset you can export to CSV, JSON, Excel or HTML, or pull straight from the API and webhooks — ideal for a tweet engagement dataset.

Is this a Twitter timeline scraper?

Yes. Point it at any @handle and it walks the public timeline with cursor pagination to pull hundreds of tweets per profile with full engagement metrics.

---

🔗 Works great with

• 🐦 X (Twitter) Profile & Email Scraper — enrich the authors with contact details.
• 🐦 X (Twitter) Post Scraper by URL — grab specific posts in bulk.

---

📝 Changelog

2026-06-07

• Docs: added coverage for scraping tweets without an API key or login, exporting tweets to CSV/JSON, and using the actor as a Twitter timeline scraper / API alternative.

2026-06-05

• 🛡️ Reliability fix: results are no longer dropped by strict output validation — runs now complete cleanly even at high volume (thousands of results).
• ⚡ Stability & performance hardening; fresh rebuild.

2026-06-04

• Verified live & refreshed build — reliability/maintenance pass.