Twitter Users API

Twitter (X) Users Details API for Complete Profile and Relationship Data

Fetch public Twitter (X) user profiles by ID or username, run batch lookups, and retrieve timelines, followers, following, mentions, subscriptions, and long-form Articles as structured JSON.

11 user-specific endpoints
1 credit per profile lookup
Failed requests cost 0 credits
1,000 free credits
No credit card required
GET /v1/twitter/users/{user_id}/by_id
TWITTER
{
  "data": {
    "id": "44196397",
    "username": "elonmusk",
    "name": "Elon Musk",
    "bio": "Mars & Cars, Chips & Dips",
    "followers_count": 170000000,
    "following_count": 500,
    "tweet_count": 45000,
    "verified": true,
    "created_at": "2009-06-02T20:12:29Z",
    "profile_image_url": "https://pbs.twimg.com/..."
  }
}
Endpoints

11 Users Endpoints

All endpoints return structured JSON and authenticate with your API key in the x-api-key header.

GETGet User by ID

Get a complete user profile by numeric Twitter ID. Returns bio, follower/following counts, verification status, join date, and profile images.

/v1/twitter/users/{user_id}/by_id
GETGet User by Username

Look up any Twitter user by their @username. Get the complete profile including bio, stats, verification status, and profile images in one call.

/v1/twitter/users/{username}/by_username
GETBatch Get Users by IDs

Look up to 100 Twitter profiles at once by numeric IDs. Perfect for enriching user datasets, CRM imports, and bulk profile analysis.

/v1/twitter/users/batch_by_ids
GETBatch Get Users by Usernames

Pass up to 100 Twitter usernames and get complete profile data for all of them in a single API call.

/v1/twitter/users/batch_by_usernames
GETGet User Tweets

Get all tweets from any user's timeline with text, media, engagement metrics, and metadata. Paginate through their entire tweet history.

/v1/twitter/users/{username}/latest_tweets
GETGet User Followers

Get the full list of followers for any Twitter account with complete profile data. Analyze audiences, find leads, and research influencer reach.

/v1/twitter/users/{username}/followers
GETGet User Following

Retrieve the complete following list of any Twitter account. Discover who they follow, analyze network connections, and map social graphs.

/v1/twitter/users/{username}/followings
GETGet User Subscriptions

See which premium accounts a user subscribes to. Analyze creator economy patterns and subscription-based engagement on Twitter.

/v1/twitter/users/{user_id}/subscriptions
GETSearch Users

Find Twitter users by searching names, usernames, and bios. Get full profile data for each result. Perfect for prospecting and audience discovery.

/v1/twitter/users/search_users
GETGet User Mentions

Get every tweet that mentions a specific user. Perfect for brand monitoring, customer feedback tracking, and reputation management.

/v1/twitter/users/{username}/mentions
GETGet User Articles

Retrieve all long-form articles published by a specific Twitter user. Ideal for content analysis, curation, and competitive research.

/v1/twitter/users/{user_id}/articles
Cost Calculator

Estimate your users scraping cost

Failed requests never consume credits, and the exact charge is returned in the X-Credits-Used response header.

Total credits for 1,000 users requests21,000
Loading plans…
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. No hidden fees, no lock-in.

FAQ

Frequently asked questions

Everything you need to know about the Twitter Users API.

What is a Twitter Users Details API?

A Twitter Users Details API retrieves public user-profile data and returns it in a format an application can use. ScrapeBadger provides dedicated endpoints for profile lookup by ID or username, batch lookups, user timelines, followers, following, subscriptions, mentions, user search, and Twitter Articles published by a user.

Do I need a Twitter or X developer account?

The documented ScrapeBadger endpoints authenticate with a ScrapeBadger API key in the x-api-key header. You do not send an X bearer token or complete an X OAuth flow when making these requests.

Can I look up multiple users in one request?

Yes. The batch endpoints accept comma-separated user IDs or usernames and return a full profile object for each resolved user, which is the efficient option for enriching stored ID lists or monitoring a fixed set of accounts.

Can I retrieve a user's followers and following lists?

Yes. The followers and following endpoints return user-profile objects for the accounts in each list and support cursor-based pagination, so large lists can be collected page by page.

How does pagination work?

Paginated responses include a top-level next_cursor. Pass that value through the endpoint’s cursor parameter to request the next page. Continue until next_cursor is null or absent.

What data does a user profile response contain?

Depending on the endpoint and the account, the response can include the user ID, username, display name, bio, location, profile and banner images, verification status, follower and following counts, tweet count, account creation date, and pinned or highlighted content indicators.

How much does the Twitter Users API cost?

Single and batch profile lookups cost 1 credit per successful request. List endpoints such as followers, following, user tweets, and mentions cost 1 base credit plus 1 credit for each item returned. Failed 4xx and 5xx requests use 0 credits, and the exact charge is returned in the X-Credits-Used response header.

Does the Twitter Users API have rate limits?

Yes. Request-per-minute limits depend on the selected ScrapeBadger plan. See the pricing table for the current limits per plan tier.

More Twitter Data APIs

Start building with the Users API

Sign up free and get 1,000 API credits. No credit card required.

Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with X Corp. (formerly Twitter, Inc.) or any of its subsidiaries or affiliates. The names Twitter, X, and related trademarks are the property of their respective owners.