X
XScraper

Get User Followers

GET

Get followers of a specific Twitter user

GET /api/v1/twitter/users/followers/:userId

Authorization

X-API-Key
string
required

Parameters

NameTypeRequiredDescription
userIdstring
required
The Twitter user ID
limitnumber
optional
Maximum number of followers to return
Default: 20
cursorstring
optional
Pagination cursor for fetching next page of results

Example Request

curl -X GET \
"https://api.xscraper.xyz/api/v1/twitter/users/followers/44196397?limit=10" \
-H "X-API-Key: "

Response

User Followers
application/json
{
  "data": {
    "profiles": [
      {
        "avatar": "https://pbs.twimg.com/profile_images/1234567890/user_400x400.jpg",
        "biography": "Twitter user biography",
        "followersCount": 1500,
        "followingCount": 500,
        "isPrivate": false,
        "isVerified": false,
        "isBlueVerified": true,
        "joined": "2015-06-02T20:12:29.000Z",
        "name": "User Name",
        "userId": "987654321",
        "username": "username",
        "website": "https://example.com"
      }
    ],
    "next": "cursor_token_for_next_page",
    "previous": null
  },
  "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/followers/44196397",
  "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/followers/nonexistentuser",
  "method": "GET",
  "message": "User not found"
}