Twitter User by ID API | Profile Lookup by ID
Resolve a numeric user ID into the full user object. Use this when you already have the stable ID (handles can change, IDs do not). Cost: $0.0008 per call.
User Info by ID resolves a numeric Twitter/X user ID into the full user object: bio, follower and following counts, verification, location, and avatar. Use it when you already hold the stable ID, since handles can change but IDs do not. It is a single $0.0008 read with bearer auth.
Authorization
bearerAuth Pass your API key as a bearer token on every request: Authorization: Bearer <API_KEY>.
In: header
Query Parameters
Numeric ID of the user.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/user/info_by_id?user_id=745273"{ "user": { "id": "745273", "username": "naval", "name": "Naval", "followers_count": 2100000, "verified": true }}{ "error": "bad_request", "message": "Missing or malformed parameter. Fix the request before retrying."}{ "error": "unauthorized", "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}{ "error": "insufficient_credits", "message": "Your balance is exhausted. Top up your credits to continue."}{ "error": "not_found", "message": "The resource does not exist, for example a deleted tweet or a private account."}{ "error": "rate_limited", "message": "Too many requests. Back off and retry with exponential backoff."}{ "error": "server_error", "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}Pricing
| Unit | Price |
|---|---|
| Per call | $0.0008 |
| Per 1,000 calls | $0.80 |
When to use
Use it to re-resolve a profile from a stored ID, for example refreshing follower counts for accounts you track by ID.
Related endpoints
- User Info by Username: Fetch a full profile by @handle.
- User Followers: Page through the accounts that follow a user.
- User Following: Page through the accounts a user follows.
FAQ
When should I use ID instead of username?
Use the ID when you already have it. The numeric ID is permanent, while a handle can be changed by the account owner.
Where do I get a numeric user ID?
Every user object returned by the API carries its id field. Capture it once from any profile, search, or follower call.
Does it return the same fields as the username lookup?
Yes. The response is the same full user object as User Info by Username, just keyed on the numeric ID.
User Info by Username GET
Resolve a username into the full user object: bio, follower and following counts, verification status, location, and avatar. The canonical entry point for profile lookups. Cost: $0.0008 per call.
User About GET
Read a profile's full About object: identity, bio, location, linked website, avatar, verification and identity-verification flags, professional account type and categories, follower and following counts, the account creation date, and X's "About this account" transparency panel (account country, how the account was created, and username-change history). Cost: $0.0008 per call.