Twitter X Scraper Pro

Twitter X Scraper Pro (Apify Actor) 🚀

High‑quality, reliable Twitter (X) data extraction for profiles, timelines, follow graphs, tweets, media, searches, and replies — designed for speed, stability, and a beautiful UX in Apify. Save clean, structured data to your dataset with zero hassle.

Table of Contents

• Features
• Endpoints
• Input Parameters
• Quick Start
• Examples (inputs)
• Output Overview
• Best Practices
• FAQ
• Find Me Better

Features

• 🔎 Profile metadata by screenname
• 🧾 User timeline with optional cursor
• 👥 Following and Followers lists (paginated)
• 🖼️ User media feed
• 🧵 Tweet details, Replies, and Retweets
• 🔍 Search tweets (with pagination)
• ⏱️ Built‑in rate limiter (rateLimitPerHour)
• 📦 Clean, structured dataset output

Endpoints

Endpoint	Purpose
screenname	Get profile metadata by handle
timeline	User tweets (supports cursor)
following	Accounts the user follows (supports cursor)
followers	Accounts following the user (supports cursor)
usermedia	Media posts from a user (supports cursor)
tweet	Single tweet details by id
replies	Replies for a tweet by id (supports cursor)
retweets	Retweets for a tweet by id (supports cursor)
search	Search tweets by query q (supports cursor)

Input Parameters

Field	Type	Required	Applies To	Notes
endpoint	string	Yes	All	One of: screenname, timeline, following, followers, usermedia, tweet, replies, retweets, search
screenname	string	Yes	screenname, timeline, following, followers, usermedia	Handle without @
id	string	Yes	tweet, replies, retweets	Tweet ID
query	string	Yes	search	Search query string
cursor	string	No	timeline, following, followers, usermedia, replies, retweets, search	Use for pagination
rateLimitPerHour	integer	No	All	Throttle requests (default 1000)

Quick Start

1. Open the actor on Apify and click Run.
2. Choose an Mode and provide required params.
3. Run the actor. Results will appear in the default dataset.
4. Export results as JSON/CSV/Excel.

Examples (inputs)

// following list
{ "endpoint": "following", "screenname": "elonmusk" }

// followers list with cursor
{ "endpoint": "followers", "screenname": "elonmusk", "cursor": "HBaE2pGdj9GLqjEAAA==" }

// tweet details
{ "endpoint": "tweet", "id": "1980443661533081665" }

// retweets for a tweet (paginated)
{ "endpoint": "retweets", "id": "1980443661533081665", "cursor": "HBaE2pGdj9GLqjEAAA==" }

// replies for a tweet
{ "endpoint": "replies", "id": "1980443661533081665" }

// replies with cursor (next page)
{ "endpoint": "replies", "id": "1980443661533081665", "cursor": "HBaE2pGdj9GLqjEAAA==" }

// user media
{ "endpoint": "usermedia", "screenname": "KylieJenner" }

// user media with cursor (next page)
{ "endpoint": "usermedia", "screenname": "KylieJenner", "cursor": "HBaE2pGdj9GLqjEAAA==" }

// search tweets
{ "endpoint": "search", "query": "elonmusk", "cursor": "HBaE2pGdj9GLqjEAAA==" }

Configuration

• Optional throttling variable: RATE_LIMIT_PER_HOUR (can also be set per run via rateLimitPerHour).

Output Overview (abridged)

• For screenname, one dataset item:

{
  "success": true,
  "endpoint": "screenname",
  "screenname": "elonmusk",
  "profile": { "status": "active", "rest_id": "44196397", "name": "Elon Musk", "blue_verified": true, "avatar": "..." },
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

• For timeline, one dataset item per tweet:

{
  "success": true,
  "endpoint": "timeline",
  "screenname": "KylieJenner",
  "tweet": { "tweet_id": "...", "text": "...", "created_at": "...", "author": { "screen_name": "KylieJenner" } },
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

• For following, one dataset item per account:

{
  "success": true,
  "endpoint": "following",
  "screenname": "elonmusk",
  "item": { "rest_id": "...", "name": "...", "screen_name": "...", "blue_verified": true },
  "group": "users",
  "next_cursor": "DAABCgAB...",
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

• For followers, one dataset item per account:

{
  "success": true,
  "endpoint": "followers",
  "screenname": "elonmusk",
  "item": { "rest_id": "...", "name": "...", "screen_name": "...", "blue_verified": false },
  "group": "users",
  "next_cursor": "DAABCgAB...",
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

• For usermedia, one dataset item per media post:

{
  "success": true,
  "endpoint": "usermedia",
  "screenname": "KylieJenner",
  "item": { "tweet_id": "...", "media": [{ "type": "photo", "media_url_https": "..." }] },
  "group": "media",
  "next_cursor": "DAABCgAB...",
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

• For tweet, a single dataset item with details:

{
  "success": true,
  "endpoint": "tweet",
  "id": "1980443661533081665",
  "tweet": { "tweet_id": "1980443661533081665", "text": "...", "created_at": "...", "author": { "screen_name": "..." } },
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

• For replies, one dataset item per reply:

{
  "success": true,
  "endpoint": "replies",
  "id": "1980443661533081665",
  "item": { "tweet_id": "...", "text": "...", "author": { "screen_name": "..." } },
  "group": "timeline",
  "next_cursor": "DAABCgAB...",
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

• For retweets, one dataset item per user who retweeted:

{
  "success": true,
  "endpoint": "retweets",
  "id": "1980443661533081665",
  "item": { "rest_id": "...", "name": "...", "screen_name": "..." },
  "group": "retweets",
  "next_cursor": "DAABCgAB...",
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

• For search, one dataset item per matching tweet or entity:

{
  "success": true,
  "endpoint": "search",
  "query": "elonmusk",
  "search_type": "Latest",
  "item": { "tweet_id": "...", "text": "...", "author": { "screen_name": "..." } },
  "group": "timeline",
  "next_cursor": "DAABCgAB...",
  "fetched_at": "2025-11-03T00:00:00.000Z"
}

Quick Start

1. Open the actor on Apify and click Run.
2. Choose endpoint and provide screenname (and cursor for timeline if needed).
3. Run the actor. Items are saved to the default dataset.
4. Export results as JSON/CSV/Excel.

Related Actors

• Twitter X Video Downloader: https://apify.com/igview-owner/twitter-x-video-downloader
• X (Twitter) Profile Viewer: https://apify.com/igview-owner/x-twitter-profile-viewer

Best Practices

• Provide valid public accounts. Private or restricted data may not be available.
• Use cursors from the API response to paginate timelines across runs.

FAQ

• ❓ Does this download media files? → No, it returns metadata and links present in the response.
• ❓ Why are some fields missing? → Availability depends on public data and platform behavior.
• ❓ Can I paginate? → Yes, many endpoints support cursor. Use it across runs to fetch next pages.
• ❓ Can you add more endpoints? → Yes. Tell us which ones you need and we’ll extend the actor.

Find Me better

twitter x scraper, twitter data extractor, x.com scraping, twitter timeline scraper, twitter followers scraper, twitter following scraper, twitter user media, tweet details api, twitter replies retweets, social media scraping, apify actor twitter, twitter dataset export, twitter research tool, influencer analytics twitter

---

For any issues or feature requests, please open an issue on your project tracker or contact the actor author. 🧑‍💻