Skip to content
Browse the docs

Profiles

Username to user ID

Resolve a screen name to its numeric user ID.

GET/api/v1/twitter/users/user_id/:username

Price

1 token per successful call. 1 per call. Failed calls are refunded; a 404 is charged.

Parameters

usernamepathrequired
Screen name without the @. Example: elonmusk

Request

curl
curl "https://api.xscraper.online/api/v1/twitter/users/user_id/elonmusk" \
  -H "x-api-key: $XSCRAPER_KEY"

Response

200 OK (example shape)
{
  "success": true,
  "message": "…",
  "data": {
    "userId": "2244994945",
    "username": "XDevelopers",
    "name": "Developers",
    "url": "https://x.com/XDevelopers",
    "biography": "The voice of the X Dev team and your official source for updates, news, and events, related to the X API.",
    "bioLinks": [],
    "location": "127.0.0.1",
    "website": "https://docs.x.com/",
    "avatar": "https://pbs.twimg.com/profile_images/1683501992314798080/xl1POYLw.jpg",
    "banner": "https://pbs.twimg.com/profile_banners/2244994945/1690213128",
    "joined": "2013-12-14T04:35:55.000Z",
    "followersCount": 698112,
    "followingCount": 765,
    "friendsCount": 765,
    "tweetsCount": 4349,
    "likesCount": 2685,
    "mediaCount": 830,
    "listedCount": 2978,
    "pinnedTweetIds": [
      "2019881223666233717"
    ],
    "isPrivate": false,
    "isVerified": false,
    "isBlueVerified": true,
    "verifiedType": "Business",
    "canDm": true,
    "professional": {
      "type": "Business",
      "categories": [
        "Community"
      ]
    },
    "affiliation": {
      "label": "X",
      "url": "https://twitter.com/X",
      "badgeUrl": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg"
    },
    "parodyLabel": null,
    "defaultProfile": false,
    "defaultProfileImage": false,
    "possiblySensitive": false
  },
  "errors": null
}

Try it

Estimated cost 1 token

Kept in this tab only and sent only as the x-api-key header of this request.

Screen name without the @.

GET /api/v1/twitter/users/user_id/elonmusk

The response, its status and the tokens it cost appear here.