xAPIs.dev
API Reference · v2
Free Tools{ }OpenAPI YAMLGet API key
API Reference / User / Get followers

Get followers

GET/twitter/user/followers30 credits

Page through the followers of an account. Results are cursor-paginated and return lightweight user objects. The sample response below is captured from the live API. List endpoints paginate with `has_next_page` and `next_cursor`.

Authentication required
Send your key in the x-api-key header. Requests without a valid key return 401.

Query parameters

userName
stringrequired
The @handle to fetch followers for.
pageSize
integeroptional
Results per page. Defaults to 40.
cursor
stringoptional
Pagination cursor returned by the previous page.

Response fields

followersarray
Array of follower user objects.
has_next_pageboolean
Whether another page of results is available.
next_cursorstring
Cursor for the next page; null or empty when exhausted.
statusstring
Request status: "success" or "error".
msgstring
Status message from the upstream.
codeinteger
Numeric status code (0 = OK).
Request
curl https://v2.xapis.dev/twitter/user/followers \
  -G --data-urlencode "userName=elonmusk" \
  -G --data-urlencode "pageSize=40" \
  -H "x-api-key: $XAPIS_KEY"
Response200 OK
application/json
{
  "followers": [
    {
      "id": "2073802671652229120",
      "name": "OGENRWOTH GEOFFREY",
      "screen_name": "OGENRWOTHGEOFRE",
      "userName": "OGENRWOTHGEOFRE",
      "location": "",
      "url": null,
      "description": "BUSINESS  MAN",
      "email": null,
      "protected": false,
      "verified": false,
      "followers_count": 0,
      "following_count": 115,
      "friends_count": 115,
      "favourites_count": 10,
      "statuses_count": 7,
      "media_tweets_count": 0,
      "created_at": "Sun Jul 05 16:17:37 +0000 2026",
      "profile_banner_url": null,
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/2073804521868771328/QcOk0WvD_normal.jpg",
      "can_dm": false
    }
  ],
  "has_next_page": true,
  "next_cursor": "1870135442428257396",
  "status": "success",
  "msg": "success",
  "code": 0
}
base url · https://v2.xapis.dev
Ready to call Get followers?