🐦 Twitter / X Profile Scraper Plus 🚀

A fast Twitter Profile Scraper (X profile scraper) that returns clean, flat profile records — one row per account with real columns for followers, following, verification, bio, location, website, join date and pinned tweet — plus each account's tweets enriched with view counts, media URLs and engagement metrics. Built for lead generation, influencer research, competitor analysis and social listening.

Works with plain usernames, @handles, numeric user IDs, or full x.com / twitter.com URLs. No login is required for public profiles and tweets; login cookies are only needed if you turn on reply scraping.

---

🌟 What it does

• Flat profile records — instead of burying profile data in a nested object, every profile is a top-level row with dedicated columns: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount, verified, isBlueVerified, verifiedType, protected, location, website, joinedAt, profileImageUrl, profileBannerUrl, pinnedTweetId, professionalCategory and the bio.
• Profiles-only mode — onlyUserInfo returns exactly one clean profile row per account and skips tweets.
• Tweets with view counts — each tweet row includes viewCount (impressions), likes, retweets, replies, quotes, bookmarks, language, media URLs and the direct tweet URL.
• Derived metrics (computed locally, no extra requests) — followerFollowingRatio, accountAgeDays, tweetsPerDay on profiles and engagementRate on tweets.
• Filters — date range, keywords / exclude-keywords, language, minimum likes / retweets / replies, media-only / video-only / image-only, exclude replies.
• Replies (optional) — labelled type=reply, isChild=true and linked to the parent tweet via parentTweetId. Requires your own x.com login cookies.

---

🔧 Input

Field	Type	Description
startUrls	array	Profile URLs, @handles, usernames or numeric IDs.
twitterHandles	array	Usernames without @; merged with startUrls.
maxItems	integer	Hard cap on total rows (profiles + tweets + replies). Default 10.
onlyUserInfo	boolean	Profiles-only run: one flat profile row per account, no tweets. Default false.
includeUserInfo	boolean	Prepend one profile row before each account's tweets. Default false.
start / end	string	Tweet date bounds — absolute (YYYY-MM-DD) or relative (7 days).
keywords / excludeKeywords	array	Keep / drop tweets by text (case-insensitive).
language	string	Keep only tweets in this language code (e.g. en).
minFavorites / minRetweets / minReplies	integer	Minimum engagement thresholds for tweets.
excludeReplies	boolean	Drop tweets that are replies to other tweets.
includeNativeRetweets	boolean	Include RT @… native retweets. Default false.
onlyImages / onlyVideos / hasMedia	boolean	Media-type filters for tweets.
getReplies	boolean	Fetch replies to each qualifying tweet (needs cookies).
minReplyCount	integer	Only fetch replies for tweets with at least this reply count.
authToken / csrfToken	string (secret)	auth_token and ct0 cookies from x.com — only for getReplies.
proxyConfiguration	object	Apify proxy configuration.

Example input

{
  "startUrls": ["https://x.com/elonmusk", "nasa"],
  "maxItems": 20,
  "onlyUserInfo": false,
  "includeUserInfo": true,
  "minFavorites": 100,
  "language": "en",
  "proxyConfiguration": { "useApifyProxy": true }
}

---

📤 Output

Profile record (type: "profile")

{
  "type": "profile",
  "userId": "44196397",
  "screenName": "elonmusk",
  "name": "Elon Musk",
  "profileUrl": "https://x.com/elonmusk",
  "description": "…",
  "followersCount": 229033543,
  "followingCount": 1226,
  "tweetCount": 89153,
  "listedCount": 165176,
  "likesCount": 182734,
  "mediaCount": 4211,
  "verified": false,
  "isBlueVerified": true,
  "verifiedType": "Blue",
  "protected": false,
  "location": "…",
  "website": "https://…",
  "joinedAt": "2009-06-02T20:12:29Z",
  "profileImageUrl": "https://pbs.twimg.com/profile_images/….jpg",
  "profileBannerUrl": "https://pbs.twimg.com/profile_banners/…",
  "pinnedTweetId": "…",
  "professionalCategory": null,
  "followerFollowingRatio": 186813.657,
  "accountAgeDays": 6240,
  "tweetsPerDay": 14.29,
  "scrapedAt": "2026-07-02T00:00:00Z"
}

Tweet record (type: "tweet" / type: "reply")

{
  "type": "tweet",
  "isReply": false,
  "id": "1519480761749016577",
  "url": "https://x.com/elonmusk/status/1519480761749016577",
  "text": "…",
  "createdAt": "2022-04-28T00:56:58Z",
  "likeCount": 4289223,
  "retweetCount": 594435,
  "replyCount": 170050,
  "quoteCount": 167104,
  "bookmarkCount": 21112,
  "viewCount": 123456789,
  "engagementRate": 0.0421,
  "lang": "en",
  "userId": "44196397",
  "screenName": "elonmusk",
  "parentTweetId": null,
  "hashtags": [],
  "mentions": [],
  "mediaUrls": [],
  "videoUrls": [],
  "mediaType": null,
  "scrapedAt": "2026-07-02T00:00:00Z"
}

Fields that are genuinely unavailable are returned as null (never faked).

---

⚖️ Legal & compliance

This scraper collects only publicly available data from Twitter/X. Do not scrape private / login-gated data, and comply with Twitter/X Terms of Service and applicable data-protection laws (GDPR/CCPA). Use the data ethically and lawfully.

---

❓ FAQ

Does it need login? No — public profiles and tweets are scraped without login. Cookies are only required for getReplies.

Can I get just the profile without tweets? Yes — enable onlyUserInfo for one clean profile row per account.

Are follower/following lists included? No. Follower/following list extraction is heavily rate-limited and cookie-sensitive on X, so it is intentionally not shipped rather than provided as an unreliable option.

Keywords for discoverability: twitter profile scraper, x profile scraper, twitter scraper python, twitter user scraper, twitter followers count, x profile data, twitter bio scraper, tweet scraper, twitter profile image scraper, apify twitter scraper.