X
XScraper

Get User ID

GET

Resolve a Twitter username to a numeric user ID

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

Authorization

X-API-Key
string
required

Parameters

NameTypeRequiredDescription
usernamestring
required
The Twitter username

Example Request

curl -X GET \
  https://api.xscraper.xyz/api/v1/twitter/users/user_id/elonmusk \
  -H "X-API-Key: "

Response

User ID
application/json
{
  "data": {
    "userId": "44196397"
  },
  "meta": {
    "statusCode": 200,
    "timestamp": "2025-04-19T15:49:28.824Z"
  }
}

Error Responses

401 Unauthorized
{
  "statusCode": 401,
  "timestamp": "2025-04-19T15:49:28.824Z",
  "path": "/api/v1/twitter/users/user_id/elonmusk",
  "method": "GET",
  "message": "Invalid or expired API key"
}
404 Not Found
{
  "statusCode": 404,
  "timestamp": "2025-04-19T15:49:28.824Z",
  "path": "/api/v1/twitter/users/user_id/nonexistentuser",
  "method": "GET",
  "message": "User not found"
}