# Twitter Scraper - Scrape Tweets from X Profiles (`logiover/x-tweet-scraper`) Actor
Scrape tweets from any X / Twitter profile without an API key or login. Twitter timeline scraper with full engagement; export tweets to CSV/JSON.
- **URL**: https://apify.com/logiover/x-tweet-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 6 total users, 5 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## 🐦 Twitter Scraper — Scrape Tweets from Any X (Twitter) Profile, No API Key
    
Scrape tweets from any **X / Twitter** profile with full engagement — **likes, retweets, replies, quotes, bookmarks and views** — plus hashtags, mentions, links, media, language and the post date. Point it at any `@handle` or profile URL and it paginates the timeline to pull **hundreds of tweets per profile**.
It needs **no login, no cookies and no API key** — it reads only public data through **guest-token access over residential proxies**, so there's **zero risk to any X account**. With no headless browser, it's a fast, low-cost way to build large, analysis-ready tweet datasets — the practical **X / Twitter API alternative** for tweet data at scale.
> ### 🏆 Why this X / Twitter tweet scraper?
>
> Hundreds of tweets per profile · every engagement metric incl. **views & bookmarks** · hashtags, mentions, links & media · author context (followers + verified) · retweet/reply filters · no login / no cookies / no API key · guest-token + residential proxy = **zero ban risk** · export to JSON, CSV & Excel
***
### ✨ What this Actor does
- **📦 Hundreds of tweets per profile** — cursor pagination walks the full public timeline; you control depth with `maxTweetsPerProfile`.
- **📊 Every engagement metric** — `likeCount`, `retweetCount`, `replyCount`, `quoteCount`, `bookmarkCount` and `viewCount` on each tweet.
- **🧵 Rich tweet data** — `hashtags`, `mentions`, `urls`, `media`, `lang` and type flags (`isReply` / `isQuote` / `isRetweet`).
- **👤 Author context** — the tweet author's `username`, `name`, `followers` count and `verified` status on every row.
- **🎚️ Smart filters** — toggle `includeRetweets` and `includeReplies` independently to keep only the original tweets you want.
- **📝 Long-form supported** — the full `text` is captured, including long-form posts, not just the 280-character preview.
- **⚡ No browser** — lightweight guest-token API access, so it's fast and cheap even at large scale.
- **🛡️ Login-free & safe** — guest-token access over residential proxies; no account, no cookies you provide, and no ban risk.
- **📤 Export anywhere** — download to JSON, CSV, Excel or HTML, or pull via the Apify API and webhooks.
***
### 🚀 Quick start (3 steps)
1. **Configure** — add one or more X **@handles or profile URLs** to `profiles`, set `maxTweetsPerProfile` for depth, and optionally toggle `includeRetweets` / `includeReplies`.
2. **Run** — click **Start**. The actor resolves each profile and walks its public timeline with cursor pagination.
3. **Get your data** — download the tweets as CSV, JSON or Excel from the run page, or pull them through the Apify API.
***
### 📥 Input
Add the profiles you want, then tune depth and the retweet/reply filters. Here are three ready-to-run scenarios:
**Two profiles, original tweets only (no replies)**
```json
{
"profiles": ["nasa", "naval"],
"maxTweetsPerProfile": 200,
"includeReplies": false
}
```
**Deep single-profile archive with everything**
```json
{
"profiles": ["https://x.com/stripe"],
"maxTweetsPerProfile": 500
}
```
**Many handles into one capped dataset**
```json
{
"profiles": ["nasa", "@naval", "stripe", "openai"],
"maxTweetsPerProfile": 150,
"includeRetweets": false,
"includeReplies": false,
"maxResults": 400
}
```
| Field | Type | Description |
|---|---|---|
| `profiles` | array | **Required.** X `@handles` or profile URLs (e.g. `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 reply tweets. Default `true`. |
| `maxResults` | integer | Global cap on tweets saved across all profiles. `0` = unlimited. |
| `proxyConfiguration` | object | Residential proxy (required by X). Pre-configured (Apify Proxy · RESIDENTIAL group). |
***
### 📤 Output
Each tweet is saved as one structured record. Here is a trimmed example:
```json
{
"tweetId": "2059393717111308634",
"url": "https://x.com/NASA/status/2059393717111308634",
"text": "On Tuesday, June 9, we'll announce the four astronauts who will fly around the Moon on Artemis II.",
"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/artemis"],
"media": [{ "type": "photo", "url": "https://pbs.twimg.com/media/Gx1a2b3c.jpg" }],
"author": { "username": "NASA", "name": "NASA", "followers": 92089565, "verified": true },
"fromProfile": "NASA"
}
```
📋 Full field reference (click to expand)
| Field | Description |
|---|---|
| `tweetId` | Unique tweet ID |
| `url` | Direct link to the tweet |
| `text` | Full tweet text (long-form posts supported) |
| `createdAt` | Post date/time |
| `lang` | Detected language code |
| `likeCount` | Likes |
| `retweetCount` | Retweets |
| `replyCount` | Replies |
| `quoteCount` | Quote tweets |
| `bookmarkCount` | Bookmarks |
| `viewCount` | Views / impressions (when X exposes it) |
| `isReply` | True if the tweet is a reply |
| `isQuote` | True if the tweet quotes another tweet |
| `isRetweet` | True if the tweet is a retweet |
| `hashtags` | Hashtags in the tweet (array) |
| `mentions` | Mentioned @handles (array) |
| `urls` | Links in the tweet (array) |
| `media` | Photos / videos, each with `type` and `url` |
| `author.username` | Author @username |
| `author.name` | Author display name |
| `author.followers` | Author follower count |
| `author.verified` | Author verified status |
| `fromProfile` | The input profile this tweet came from |