---
title: "Get Followers by Page"
method: POST
path: "/twitter/followers/page"
tags: ["Followers & Following Endpoints"]
---

# Get Followers by Page

`POST /twitter/followers/page`

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/twitter/followers/page`
- Auth: HTTP bearer

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.

## Request body

- GetFollowersCursorQuery
  - `next_cursor` string, nullable: Cursor returned by the previous page. Leave empty to fetch the first page.
  - `screen_name` string, required: Twitter screen name of the target user (with or without @).

## Response `200`

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

- GetFollowersCursorResponse
  - `code` integer: HTTP status code
  - `msg` string: Response message
  - `data` UserInfo[], required: Current page follower items.
    - `userId` string, required: User ID
    - `isBlueVerified` boolean, required: Blue verification status
    - `createdAt` string, required: Account creation date
    - `createdAtDatetime` string, nullable: Account creation datetime in ISO format
    - `defaultProfile` boolean, required: Default profile flag
    - `defaultProfileImage` boolean, required: Default profile image flag
    - `description` string, required: Bio description
    - `location` string, required: Location
    - `fastFollowersCount` integer, required: Fast followers count
    - `favouritesCount` integer, required: Likes count
    - `followersCount` integer, required: Followers count
    - `followingCount` integer, required: Following count
    - `hasCustomTimelines` boolean, required: Has custom timelines flag
    - `isTranslator` boolean, required: Is translator flag
    - `listedCount` integer, required: Listed count
    - `mediaCount` integer, required: Media count
    - `name` string, required: Display name
    - `normalFollowersCount` integer, required: Normal followers count
    - `pinnedTweetIdsStr` unknown[], nullable: Pinned tweet IDs
      - unknown
    - `possiblySensitive` boolean, required: Possibly sensitive flag
    - `profileImageUrlHttps` string, required: Profile image URL
    - `username` string, required: Username
    - `statusesCount` integer, required: Tweets count
    - `translatorType` string, nullable: Translator type
    - `verified` boolean, required: Legacy verification status
    - `verified_type` string, nullable: Verification badge type: blue, business, government, etc.
    - `withheldInCountries` unknown[], nullable: Withheld in countries
      - unknown
    - `protected` boolean, required: Protected account flag
    - `url` string, nullable: User profile URL
    - `descriptionUrls` unknown[], nullable: Description URLs
      - unknown
    - `urls` unknown[], nullable: User URLs
      - unknown
    - `pinnedTweetIds` unknown[], nullable: Pinned tweet IDs
      - unknown
  - `has_next_page` boolean, required: Whether another page is available.
  - `next_cursor` string, nullable: Use this cursor to fetch the next page when has_next_page is true.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/twexapi/apis/twexapi-rest-api.md) · [All operations](https://skmtc.dev/twexapi/apis/twexapi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twexapi/apis/twexapi-rest-api/revisions/59a99ac0d8f7?raw)