Get Followers

Get followers of a user, $0.05/1000 followers. When count > 5000, returns a task_id immediately (HTTP 202). Use GET /twitter/followers/task/{task_id}/status to check progress, and GET /twitter/followers/task/{task_id}/next to consume pages one by one.

Back to API Reference

/Followers & Following Endpoints

TwexAPI REST

GET/twitter/followers/{screen_name}/{count}

Authorization

AuthorizationBearer token · headerrequired

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

Path Parameters

screen_namestringrequired

The screen name of the user to get followers.

countintegerrequired

The number of followers to get.

Responses

200A list of user info, or a task_id for large requests

codeinteger

HTTP status code

default: 200

msgstring

Response message

default: "success"

dataUserInfo | any[] | FriendshipTaskDatarequired

List of user info, or task handle when count exceeds async threshold

Show properties

Any of:

UserInfo | any[]

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

FriendshipTaskData

task_idstringrequired

Task ID for polling status/next endpoints

reusedbooleanrequired

True if an in-flight task was reused

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 APIGET/twitter/followers/{screen_name}/{count}

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.

⚙️Parameters (2)

screen_namepath

RequiredThe screen name of the user to get followers.

countpath

RequiredThe number of followers to get.

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

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

Request

curl -X GET "https://api.twexapi.io/twitter/followers/elonmusk/200" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.twexapi.io/twitter/followers/elonmusk/200", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.twexapi.io/twitter/followers/elonmusk/200",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

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
      ]
    }
  ]
}

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