X User Lookup
GET
/v1/x/users/{handle}MCP
x_user3 creditsLiveUpdated
Description
Look up an X (Twitter) account by handle: name, bio, follower and following counts, tweet count, verification, whether it accepts DMs, location, website, avatar and join date. Costs 3 credits. Tip: canDm tells you if a cold DM can reach this account before you spend on x.dm_send.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
handle | path | string | yes | Handle with or without @, or a profile URL. 1-15 characters. |
- handle path, string, required
- Handle with or without @, or a profile URL. 1-15 characters.
Request examples
curl "https://chatterapi.com/v1/x/users/levelsio" \
-H "Authorization: Bearer $CHATTERAPI_KEY"Response
data is one XUser. Fields:
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | no | Platform id. |
handle | string | no | Handle without @. |
name | string | no | Name. |
bio | string | yes | Profile bio. |
followers | number | yes | Follower count. |
following | number | yes | Following count. |
tweets | number | yes | Tweet count. |
verified | boolean | yes | Legacy verification. |
blueVerified | boolean | yes | Paid blue check. |
canDm | boolean | yes | Whether the account accepts DMs from anyone. |
protected | boolean | yes | Protected (private) account. |
location | string | yes | Profile location. |
url | string | yes | Website in the profile. |
avatarUrl | string | yes | Avatar image URL. |
createdAt | string | yes | ISO 8601 UTC timestamp. |
response
{
"data": {
"id": "1577241403",
"handle": "levelsio",
"name": "@levelsio",
"bio": "💸http://levels.vc\n📸http://PhotoAI.com $86K/m\n🎮http://VibeJam.com $44K/m\n🏡http://InteriorAI.com $23K/m\n👙@X $13K/m\n🌍http://Nomads.com $7K/m\n🏩http://Hotelist.com $5K/m",
"followers": 974707,
"following": 3276,
"tweets": 181450,
"verified": false,
"blueVerified": true,
"canDm": false,
"protected": false,
"location": "📕My book $5K/m 👉",
"url": "https://readMAKE.com",
"avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_400x400.jpg",
"createdAt": "2013-07-08T09:31:59.000Z"
},
"credits": {
"charged": 3,
"remaining": 24997
},
"requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
"cached": false
}Recorded live response captured 2026-10-13, truncated to 3 items. Credits and request id are illustrative.
Credits
3 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 1 hour are served from cache.