TwitterAPIs Docs
API ReferenceUser Reads

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.

GET
/user/info_by_id

Authorization

bearerAuth
AuthorizationBearer <token>

Pass your API key as a bearer token on every request: Authorization: Bearer <API_KEY>.

In: header

Query Parameters

user_id*string

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

UnitPrice
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.

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.