Skip to content
Browse the docs

Social graph

Followers

Accounts following a user, up to 50 per page. Pass next back as cursor for more.

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

Price

4 tokens per successful call. 3 + 1 × ceil(count ÷ 50). Failed calls are refunded; a 404 is charged.

Parameters

userIdpathrequired
Numeric user ID. Example: 44196397
countquery
Items to return, 1–50. Default 50. Example: 50
cursorquery
Cursor from a previous response's next field.

Request

curl
curl "https://api.xscraper.online/api/v1/twitter/users/followers/44196397?count=50" \
  -H "x-api-key: $XSCRAPER_KEY"

Response

200 OK (example shape)
{
  "success": true,
  "message": "…",
  "data": {
    "profiles": [
      {
        "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
      }
    ],
    "next": "1846419170546342870|2102219347227549663"
  },
  "errors": null
}

Try it

Estimated cost 4 tokens

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

Numeric user ID.

Items to return, 1–50. Default 50.

Cursor from a previous response's next field.

GET /api/v1/twitter/users/followers/44196397?count=50

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