X (Twitter) Profile & Tweets Scraper

Here is one real result, with every field the actor returns (the recentTweets array is trimmed to 1 of 20 real tweets to keep the sample short; every value shown is real):

{
  "profileImageUrl": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg",
  "username": "NASA",
  "displayName": "NASA",
  "url": "https://x.com/NASA",
  "userId": "11348282",
  "bio": "Making the seemingly impossible, possible. ✨",
  "website": "http://www.nasa.gov/",
  "location": null,
  "isVerified": true,
  "verifiedType": "Government",
  "isProtected": false,
  "accountCreated": "Wed Dec 19 20:20:32 +0000 2007",
  "followerCount": 92214690,
  "followingCount": 119,
  "tweetCount": 74248,
  "mediaCount": 28045,
  "listedCount": 97046,
  "favouritesCount": 16888,
  "bannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1775567134",
  "pinnedTweetId": null,
  "numTweetsFetched": 20,
  "recentTweets": [
    {
      "id": "2080777261897175496",
      "url": "https://x.com/NASA/status/2080777261897175496",
      "text": "RT @NASASpox: The future of flight looks bright at Oshkosh!\n\n@NASAAdmin spent time with aviation enthusiasts of all ages at EAA AirVenture,…",
      "createdAt": "Fri Jul 24 22:08:52 +0000 2026",
      "likeCount": 0,
      "replyCount": 0,
      "retweetCount": 40,
      "quoteCount": 0,
      "bookmarkCount": null,
      "viewCount": null,
      "lang": "en",
      "conversationId": "2080777261897175496",
      "possiblySensitive": false,
      "isReply": false,
      "inReplyToUsername": null,
      "isQuote": false,
      "quotedStatusId": null,
      "isRetweet": true,
      "source": null,
      "hashtags": [],
      "mentions": [
        "NASASpox",
        "NASAAdmin"
      ],
      "links": [],
      "media": []
    }
  ],
  "observedAt": "2026-07-25T08:05:12.532Z",
  "error": null
}

The most complete X (Twitter) profile scraper available. It returns every profile field X exposes publicly, from follower and tweet counts to verification type, website and banner, plus the account's most recent tweets with full engagement metrics, so you get the profile and its timeline in one record.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

Give the actor a list of X (Twitter) handles. For each one it reads the public profile from X's syndication timeline and writes a single normalized record containing the full profile plus the account's most recent tweets. Handles can be provided as @name, name, or a full profile URL; duplicates are removed automatically. Missing source values are returned as null, and each tweet carries its own engagement metrics (likes, replies, retweets, quotes, views), entities (hashtags, mentions, links), and media.

The actor reads only public data. Protected, suspended, or empty-timeline accounts return a record with a populated error field instead of profile data.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the NASA profile and its 20 most recent tweets.

{
  "handles": ["NASA"],
  "maxTweetsPerUser": 20
}

Add more handles to the handles array to scrape several accounts in one run. Set maxTweetsPerUser to 0 if you only want profile fields and no tweets.

Input reference

Field	Type	Required	Default	Description
handles	string[]	yes	(none)	Public X handles to scrape, one record per handle. Accepts @name, name, or a profile URL such as https://x.com/nasa. Duplicates are removed.
maxTweetsPerUser	integer	no	20	Maximum recent tweets to keep per handle. The syndication endpoint returns roughly the last 20 tweets, so values above that are capped by what X exposes. Set 0 for profile only.

Output reference

One dataset item per handle. Types: string, number, boolean, object[], or null when the source value is absent.

Field	Type	Description
profileImageUrl	string	Full-resolution profile avatar URL.
username	string	The account handle (screen name).
displayName	string	Display name shown on the profile.
url	string	Canonical profile URL on x.com.
userId	string	Numeric X user ID as a string.
bio	string	Profile description / bio.
website	string	Website link from the profile, or null.
location	string	Self-reported location, or null.
isVerified	boolean	Whether the account carries a verified badge.
verifiedType	string	Verification type, for example Government, Business, or null.
isProtected	boolean	Whether the account is protected (private).
accountCreated	string	Account creation timestamp as returned by X.
followerCount	number	Number of followers.
followingCount	number	Number of accounts followed.
tweetCount	number	Total tweets posted.
mediaCount	number	Total media items posted.
listedCount	number	Number of lists the account appears on.
favouritesCount	number	Number of likes the account has given.
bannerUrl	string	Profile banner image URL, or null.
pinnedTweetId	string	ID of the pinned tweet, or null.
numTweetsFetched	number	Count of tweets returned in recentTweets.
recentTweets	object[]	The account's most recent tweets. Each object holds id, url, text, createdAt, likeCount, replyCount, retweetCount, quoteCount, bookmarkCount, viewCount, lang, conversationId, possiblySensitive, isReply, inReplyToUsername, isQuote, quotedStatusId, isRetweet, source, hashtags, mentions, links, and media.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed handle, a single item with a populated error field (for example Account not found or suspended, HTTP 429) is written instead.

Example output record

Real record from a live run (input {"handles": ["NASA"], "maxTweetsPerUser": 20}), with recentTweets trimmed to 1 of 20 real tweets:

{
  "profileImageUrl": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg",
  "username": "NASA",
  "displayName": "NASA",
  "url": "https://x.com/NASA",
  "userId": "11348282",
  "bio": "Making the seemingly impossible, possible. ✨",
  "website": "http://www.nasa.gov/",
  "location": null,
  "isVerified": true,
  "verifiedType": "Government",
  "isProtected": false,
  "accountCreated": "Wed Dec 19 20:20:32 +0000 2007",
  "followerCount": 92214690,
  "followingCount": 119,
  "tweetCount": 74248,
  "mediaCount": 28045,
  "listedCount": 97046,
  "favouritesCount": 16888,
  "bannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1775567134",
  "pinnedTweetId": null,
  "numTweetsFetched": 20,
  "recentTweets": [
    {
      "id": "2080777261897175496",
      "url": "https://x.com/NASA/status/2080777261897175496",
      "text": "RT @NASASpox: The future of flight looks bright at Oshkosh!\n\n@NASAAdmin spent time with aviation enthusiasts of all ages at EAA AirVenture,…",
      "createdAt": "Fri Jul 24 22:08:52 +0000 2026",
      "likeCount": 0,
      "replyCount": 0,
      "retweetCount": 40,
      "quoteCount": 0,
      "bookmarkCount": null,
      "viewCount": null,
      "lang": "en",
      "conversationId": "2080777261897175496",
      "possiblySensitive": false,
      "isReply": false,
      "inReplyToUsername": null,
      "isQuote": false,
      "quotedStatusId": null,
      "isRetweet": true,
      "source": null,
      "hashtags": [],
      "mentions": ["NASASpox", "NASAAdmin"],
      "links": [],
      "media": []
    }
  ],
  "observedAt": "2026-07-25T08:05:12.532Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~x-profile-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"handles":["NASA","OpenAI"],"maxTweetsPerUser":20}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~x-profile-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"handles":["nasa"],"maxTweetsPerUser":10}'

Apify CLI:

apify call scrapers_lat/x-profile-scraper \
  --input '{"handles":["NASA"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

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

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per profile record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. A handle that cannot be read (not found, suspended, protected, rate-limited) is written with a populated error field and is not charged.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 handles per run. Upgrade for more.

FAQ and troubleshooting

Why did a handle return an error? The account is protected, suspended, does not exist, or X rate-limited the request (HTTP 429) at that moment. Error records are not charged. Re-run rate-limited handles.

How many tweets do I get per handle? X's public syndication timeline exposes roughly the last 20 tweets, so maxTweetsPerUser above 20 is capped by what X returns. Set it to 0 for profile fields only.

Can I pass profile URLs instead of handles? Yes. @nasa, nasa, and https://x.com/nasa are all accepted and normalized to the same handle.

Why is viewCount or bookmarkCount null on some tweets? X does not expose those counters for every tweet in the public timeline. Missing values are returned as null, never invented.

Is this an official X tool? No. This actor is independent and has no affiliation with X (formerly Twitter). It reads only data that is publicly available.

Related scrapers

• X (Twitter) Search & Tweets Scraper: search X for tweets by keyword, hashtag, or query.
• Farcaster Casts Scraper: posts and profiles from the Farcaster network.
• Behance Scraper: creative portfolios and project data.
• DeviantArt Scraper: art deviations and creator profiles.
• Dribbble Scraper: design shots and designer profiles.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with X (formerly Twitter). Accesses only publicly available profile data.