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
Endpoints

Explore All 11 Users Endpoints

Pick an endpoint to see what it does, which parameters it accepts, and the JSON your application receives. Authenticate with your API key in the x-api-key header.

GET/v1/twitter/users/{user_id}/by_id

Get User by ID

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

Parameters
user_idrequiredThe numeric Twitter user ID
Sample response
{
  "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/..."
  }
}
View Get User by ID documentation

What Can You Build With the Twitter Users Details API

Profile, relationship, and timeline data for account-level analysis.

Influencer and creator research

Retrieve full profiles, follower and following counts, verification status, and recent timelines to qualify creators, compare audiences, and build outreach lists.

Audience and network analysis

Collect follower and following lists page by page to map communities, find overlapping audiences, and identify the accounts that connect them.

Account monitoring and enrichment

Use batch lookups to refresh stored profiles on a schedule — bios, images, counts, and verification changes — and track mentions of the accounts you care about.

Lead scoring and identity checks

Resolve usernames to IDs, verify account age and activity, and pull published Articles to separate active, credible accounts from throwaways.

More Twitter Data APIs

Why Choose ScrapeBadger?

Build Faster

Sub-100ms response times. Most of that is your network latency, not our infrastructure. Deploy, test, iterate the same day instead of week-long proofs-of-concept.

Scale Confidently

99.9% uptime SLA. Your data pipeline doesn't stop because X changed a selector. Monitoring, patching, and infrastructure are all us. You focus on what you built.

All X Data on One Platform

Tweets, profiles, followers, communities, trends, geo, real-time Streams — 40+ endpoints. Whatever you need from X, it's here. No fragmented tooling, no API gaps forcing you to bolt on a second service.

Integrate Anywhere

RESTful API, SDK support (Python, Node, Go, PHP), MCP, CLI, and no code. Use it in an existing system or a new greenfield; the response shape never surprises you.

Integrate With Your Stack

Use ScrapeBadger through an official SDK, a standard API request, a real-time connection, or the tools already in your workflow.

Python SDK

Build asynchronous data pipelines with typed responses, automatic pagination, retry handling, and access to the complete Twitter API.

Node.js SDK

Add Twitter data to Node.js and TypeScript applications with type definitions, async pagination, and support for both ESM and CommonJS.

REST API

Connect from any backend or programming language using standard HTTP requests. Responses arrive as structured JSON that can be stored, transformed, or passed into another service.

WebSockets and Webhooks

Receive new tweets through a persistent WebSocket connection or deliver them directly to your application through signed webhooks. Available with Twitter Streams for account and query monitoring.

MCP for AI Tools

Give compatible AI agents access to Twitter profiles, tweets, search, trends, communities, lists, and monitoring tools through ScrapeBadger's MCP server.

ScrapeBadger CLI

Search tweets, retrieve profiles, inspect trends, and export results as JSON, CSV, Markdown, or terminal-friendly tables without writing an application.

Trusted by Developers Worldwide

See what our customers say about ScrapeBadger Twitter API.

We switched from the official Twitter API and cut our costs by 95%. The pagination is seamless, and we've never hit a rate limit. Best decision we made this year.

MC
Marcus Chen
Lead Data Engineer at DataFlow Analytics
2 weeks ago

The follower and engagement endpoints are incredibly detailed. We use it for influencer research and competitor analysis. Response times are sub-100ms consistently.

SM
Sarah Mitchell
Marketing Director at SocialPulse Agency
1 month ago

Started with the Apify actor, then moved to the API for more control. The 1,000 free credits were enough to build our MVP. Now processing 2M+ tweets monthly.

JR
James Rodriguez
Founder at TweetMetrics
3 weeks ago

Perfect for academic research. The community and trends endpoints give us data we couldn't get anywhere else. Documentation could use more examples, but support is responsive.

EW
Emily Watson
Research Scientist at Stanford NLP Lab
1 month ago

We monitor 50,000+ accounts for our clients. ScrapeBadger handles it without breaking a sweat. The bulk ID endpoints are a game-changer for large-scale monitoring.

AP
Alex Petrov
CTO at MediaMonitor Pro
2 weeks ago

The geo and trends endpoints power our location-based analytics. Setup took 10 minutes. Their Apify actors are also great for quick one-off scrapes.

LP
Lisa Park
Product Manager at Trendy AI
3 weeks ago
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. Failed requests never consume credits, and the exact charge is returned in the X-Credits-Used response header.

Not Sure Which Plan Fits Your Needs? Calculate Your Cost and Find the Right Plan.

Every endpoint uses the same model: 1 base credit + 1 credit per item returned. Single-item lookups always cost 2 credits. Paginated list endpoints cost 1 + the number of items in the page. Failed requests cost 0 credits.

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.

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.