---
title: "Get Followers"
method: GET
path: "/twitter/followers/{screen_name}/{count}"
tags: ["Followers & Following Endpoints"]
---

# Get Followers

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

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/twitter/followers/{screen_name}/{count}`
- Auth: HTTP bearer

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.

## Path parameters

- `screen_name` string, required: The screen name of the user to get followers.
- `count` integer, required: The number of followers to get.

## Response `200`

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

- GetFollowersResponse: get followers API response
  - `code` integer: HTTP status code
  - `msg` string: Response message
  - `data` union, required: List of user info, or task handle when count exceeds async threshold
    - UserInfo[]
      - `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
    - FriendshipTaskData: Async friendship fetch task handle
      - `task_id` string, required: Task ID for polling status/next endpoints
      - `reused` boolean, required: True if an in-flight task was reused

## 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)