Get Followers by Page

Retrieve a paginated list of followers using cursor-based pagination. Each page returns up to 200 followers. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 followers.

Back to API Reference

/Followers & Following Endpoints

TwexAPI REST

POST/twitter/followers/page

Authorization

AuthorizationBearer token · headerrequired

Global API Bearer Token for TwexAPI. Included as: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Request Body

requiredapplication/json

next_cursorstring | any

Cursor returned by the previous page. Leave empty to fetch the first page.

Show properties

Any of:

string

string

any

any

screen_namestringrequired

Twitter screen name of the target user (with or without @).

Responses

200Current page data (up to 200 followers) and pagination metadata (has_next_page, next_cursor).

codeinteger

HTTP status code

default: 200

msgstring

Response message

default: "success"

dataUserInfo | any[]required

Current page follower items.

Show properties

Array of UserInfo | any

Any of:

UserInfo

userIdstringrequired

User ID

isBlueVerifiedbooleanrequired

Blue verification status

createdAtstringrequired

Account creation date

createdAtDatetimestring | any

Account creation datetime in ISO format

Show properties

Any of:

string

string

any

any

defaultProfilebooleanrequired

Default profile flag

defaultProfileImagebooleanrequired

Default profile image flag

descriptionstringrequired

Bio description

locationstringrequired

Location

fastFollowersCountintegerrequired

Fast followers count

favouritesCountintegerrequired

Likes count

followersCountintegerrequired

Followers count

followingCountintegerrequired

Following count

hasCustomTimelinesbooleanrequired

Has custom timelines flag

isTranslatorbooleanrequired

Is translator flag

listedCountintegerrequired

Listed count

mediaCountintegerrequired

Media count

namestringrequired

Display name

normalFollowersCountintegerrequired

Normal followers count

pinnedTweetIdsStrany[] | any

Pinned tweet IDs

Show properties

Any of:

any[]

Array of any

any

any

any

possiblySensitivebooleanrequired

Possibly sensitive flag

profileImageUrlHttpsstringrequired

Profile image URL

usernamestringrequired

Username

statusesCountintegerrequired

Tweets count

translatorTypestring | any

Translator type

Show properties

Any of:

string

string

any

any

verifiedbooleanrequired

Legacy verification status

verified_typestring | any

Verification badge type: blue, business, government, etc.

Show properties

Any of:

string

string

any

any

withheldInCountriesany[] | any

Withheld in countries

Show properties

Any of:

any[]

Array of any

any

any

any

protectedbooleanrequired

Protected account flag

urlstring | any

User profile URL

Show properties

Any of:

string

string

any

any

descriptionUrlsany[] | any

Description URLs

Show properties

Any of:

any[]

Array of any

any

any

any

urlsany[] | any

User URLs

Show properties

Any of:

any[]

Array of any

any

any

any

pinnedTweetIdsany[] | any

Pinned tweet IDs

Show properties

Any of:

any[]

Array of any

any

any

any

any

any

has_next_pagebooleanrequired

Whether another page is available.

next_cursorstring | any

Use this cursor to fetch the next page when has_next_page is true.

Show properties

Any of:

string

string

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

⚡Interactive Console / Try APIPOST/twitter/followers/page

Live Console

🌐Target Server:https://api.twexapi.io

● Production Ready

🔍

Public Data Read (TwexAPI Key Only, No Twitter Cookie Required)

This endpoint queries public Twitter data — no Twitter account or Cookie required! Simply enter your TwexAPI Platform Key (Bearer Token) in the "API Authorization" section below to test.

🔑API Authorization

Remember keySync to code samples

TwexAPI Platform Key Bearer TokenRequired

Global API key used across all TwexAPI endpoints. Get it from the console.

📝Request Bodyapplication/json

next_cursorstring

OptionalCursor returned by the previous page. Leave empty to fetch the first page.

screen_namestring

RequiredTwitter screen name of the target user (with or without @).

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

Configure parameters in the Request tab and click Send Request below.

Request

curl -X POST "https://api.twexapi.io/twitter/followers/page" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "next_cursor": "",
  "screen_name": "elonmusk"
}'

const response = await fetch("https://api.twexapi.io/twitter/followers/page", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "next_cursor": "",
  "screen_name": "elonmusk"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/followers/page",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "next_cursor": "",
  "screen_name": "elonmusk"
},
)

Response

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "userId": "string",
      "isBlueVerified": true,
      "createdAt": "string",
      "createdAtDatetime": "string",
      "defaultProfile": true,
      "defaultProfileImage": true,
      "description": "string",
      "location": "string",
      "fastFollowersCount": 0,
      "favouritesCount": 0,
      "followersCount": 0,
      "followingCount": 0,
      "hasCustomTimelines": true,
      "isTranslator": true,
      "listedCount": 0,
      "mediaCount": 0,
      "name": "string",
      "normalFollowersCount": 0,
      "pinnedTweetIdsStr": [
        null
      ],
      "possiblySensitive": true,
      "profileImageUrlHttps": "string",
      "username": "string",
      "statusesCount": 0,
      "translatorType": "string",
      "verified": true,
      "verified_type": "blue",
      "withheldInCountries": [
        null
      ],
      "protected": true,
      "url": "string",
      "descriptionUrls": [
        null
      ],
      "urls": [
        null
      ],
      "pinnedTweetIds": [
        null
      ]
    }
  ],
  "has_next_page": true,
  "next_cursor": "1234567890"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}