Pricing

Rating

Developer

Actor stats

Categories

Share

X Profile Scraper (Apify Actor)

Fetch public X/Twitter profile data by username or profile URL — no login cookies required.

Uses X's internal Guest Token + GraphQL API (UserByScreenName).

Features

• Input: usernames (@handle or handle) and/or profileUrls (x.com/..., twitter.com/...)
• Auto-discovers rotating GraphQL queryId from X's JS bundle
• Guest token refresh on expiry, 401/403, and 429
• Apify Proxy support (recommended)

Input example

{
"usernames":["elonmusk","NASA"],
"profileUrls":["https://x.com/OpenAI"],
"delayMs":1500,
"maxRetries":2,
"tokenRefreshAfter":50,
"proxyConfiguration":{"useApifyProxy":true}
}

Output example

{
"id":"44196397",
"screen_name":"elonmusk",
"name":"Elon Musk",
"bio":"...",
"followers_count":237726440,
"following_count":1305,
"tweet_count":100356,
"is_blue_verified":true,
"profile_image_url":"https://pbs.twimg.com/profile_images/.../photo_400x400.jpg",
"profile_url":"https://x.com/elonmusk",
"scrape_method":"guest_graphql",
"scraped_at":"2026-06-08T12:00:00.000Z"
}

Local development

npminstall
apify run

Or with a local input file at storage/key_value_stores/default/INPUT.json.

Limitations

• Profiles only — no tweets, followers, or search
• Public data — protected accounts return limited info
• X rotates GraphQL query IDs every few weeks; this actor discovers them at runtime
• Datacenter IPs are often blocked — use Apify Proxy

Project structure

.actor/ Actor metadata and input schema
src/main.js Entry point and orchestration
src/guestToken.js Guest token acquisition
src/graphql.js GraphQL profile fetch
src/queryIds.js Dynamic queryId discovery
src/parseProfile.js Response parsing
src/normalizeInput.js Username /URL normalization