---
title: "GET /twitter/list/followers"
method: GET
path: "/twitter/list/followers"
---

# GET /twitter/list/followers

`GET /twitter/list/followers`

## Request

- Base URL: `https://api.twitterapi.io`
- URL: `https://api.twitterapi.io/twitter/list/followers`
- Auth: API key in header `X-API-Key`

Get followers of a list. Page size is 20.

## Query parameters

- `list_id` string, string, required
- `cursor` string, string

## Response `200`

List followers of the list

- object
  - `followers` UserInfo[]: Members of the list
    - `type` 'user'
    - `userName` string: The username of the Twitter user
    - `url` string: The x.com URL of the user's profile
    - `id` string: The unique identifier of the user
    - `name` string: The display name of the user
    - `isBlueVerified` boolean: Whether the user has Twitter Blue verification
    - `protected` boolean: Whether the account is private (protected). Only approved followers can see its posts
    - `verifiedType` string: The type of verification. eg. "government" ,can be empty
    - `profilePicture` string: URL of the user's profile picture
    - `coverPicture` string: URL of the user's cover picture
    - `description` string: The user's profile description
    - `location` string: The user's location.for example: 東京の端っこ . may be empty
    - `followers` integer: Number of followers
    - `following` integer: Number of accounts following
    - `canDm` boolean: Whether the user can receive DMs
    - `createdAt` string: When the account was created. Format depends on the endpoint: /twitter/user/info returns ISO 8601 (e.g. 2007-12-19T20:20:32.000000Z); inside tweet objects (tweet.author) it is the classic X format (e.g. Wed Dec 19 20:20:32 +0000 2007).
    - `favouritesCount` integer: Number of favorites
    - `hasCustomTimelines` boolean: Whether the user has custom timelines
    - `isTranslator` boolean: Whether the user is a translator
    - `mediaCount` integer: Number of media posts
    - `statusesCount` integer: Number of status updates
    - `withheldInCountries` string[]: Countries where the account is withheld
    - `affiliatesHighlightedLabel` object
    - `possiblySensitive` boolean: Whether the account may contain sensitive content
    - `pinnedTweetIds` string[]: IDs of pinned tweets
    - `isAutomated` boolean: Whether the account is automated
    - `automatedBy` string: The account that automated the account
    - `unavailable` boolean: Whether the account is unavailable
    - `message` string: The message of the account.eg. "This account is unavailable" or "This account is suspended"
    - `unavailableReason` string: The reason the account is unavailable.eg. "suspended"
    - `profile_bio` object
      - `description` string
      - `entities` object
        - `description` object
          - `urls` object[]
            - `display_url` string
            - `expanded_url` string
            - `indices` integer[]
            - `url` string
        - `url` object
          - `urls` object[]
            - `display_url` string
            - `expanded_url` string
            - `indices` integer[]
            - `url` string
  - `has_next_page` boolean: Indicates if there are more results available
  - `next_cursor` string: Cursor for fetching the next page of results
  - `status` 'success' | 'error': Status of the request: success or error
  - `msg` string: Message of the request, error message if status is error

## Other responses

- `400`: unexpected error

## Changes

- **2026-11-03** `03599c7e3236`: 1 info
  - added the optional property `followers/items/protected` to the response with the `200` status

[Operation history](https://skmtc.dev/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api/changes/twitter/list/followers/get.md)

---

[API](https://skmtc.dev/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api.md) - [All operations](https://skmtc.dev/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api/revisions/03599c7e3236?raw)