Skip to content

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.

Look up an X profile now, no signupThen call the same data from code.

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

  1. Look up a profile

    Call x.user with a username.

  2. Search accounts

    Call x.user_search with a keyword to find accounts that match.

  3. Check a handle

    Call x.username_check to see if a username is taken.

Endpoints that do it

EndpointWhat it's forCredits
Get a userGET /v1/x/users/{handle}A public profile by username.2 credits
Search usersGET /v1/x/users/searchAccounts matching a keyword.2 credits
Check a usernameGET /v1/x/users/{handle}/availabilityWhether 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"
response, first 2 rows
{
  "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?
Call the user endpoint once per username. Add a loop or a no-code step in n8n.
Can I find accounts by what they write?
Yes. User search matches names and bios, and tweet search finds accounts by what they post.
Is a developer account required?
No. One key from here covers the X and Reddit calls.

More ways to use the API

Build it with one API key

Try it free for 7 days with 1,000 credits.