Twitter user API
Look up any public X profile by username, search for accounts by keyword, and check whether a handle is available. Profiles come back as JSON with bio, counts and link.
The job
Profile data helps you enrich a list of leads, check a person before you reach out, or find accounts that talk about a topic. The calls return the public profile and nothing private.
It is read-only and does not need an X developer account.
How it works
Look up a profile
Call
x.userwith a username.Search accounts
Call
x.user_searchwith a keyword to find accounts that match.Check a handle
Call
x.username_checkto see if a username is taken.
Endpoints that do it
| Endpoint | What it's for | Credits |
|---|---|---|
| Get a userGET /v1/x/users/{handle} | A public profile by username. | 2 credits |
| Search usersGET /v1/x/users/search | Accounts matching a keyword. | 2 credits |
| Check a usernameGET /v1/x/users/{handle}/availability | Whether a username is taken. | 2 credits |
Free tools for the same job
Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.
Looking up a profile
Call the user endpoint with a username to see bio, followers and join date.
curl "https://api.chatterapi.com/v1/x/users/levelsio" \
-H "Authorization: Bearer $CHATTERAPI_KEY"{
"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",
"profileUrl": "https://x.com/levelsio",
"bannerUrl": "https://pbs.twimg.com/profile_banners/1577241403/1665964220",
"likesGiven": 185852,
"mediaCount": 19829,
"pinnedTweetIds": [
"2109949585737052316"
]
}
}Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.
What it won't do
- It is read-only and covers public profiles only.
- Suspended and protected accounts return limited data.
- X's rules apply to what you do with the data.
Questions
Can I look up many profiles at once?
Can I find accounts by what they write?
Is a developer account required?
Guides
More ways to use the API
- Access the Twitter API
- Claude Reddit bot
- Live Twitter monitor
- Reddit API application
- Reddit brand monitoring
- Reddit data export
- Reddit post API
- Reddit scraper API
- Social listening API
- Post with the Twitter API
- Twitter API statuses
- Twitter exporter
- Twitter scraper API
- Twitter webhook
- Reddit comments API
- Reddit user API
- Subreddit API
- Twitter followers API
- Twitter search API
- Social media scraping API
- Reddit listening tool
- Twitter feed API
- Twitter hashtag API
- Social media analytics API
- Twitter image API