> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List followers

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">1 credit</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">per request</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 Why Code When AI Can Do It For You?</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.</p>
  </div>

  <div className="mt-4">
    <button
      type="button"
      className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50"
      onClick={() => navigator.clipboard.writeText(`I want to make an API call to https://api.keyapi.ai/v1/twitter/list_followers.

Please help me write code to make this API call and handle the response appropriately. Include error handling and best practices.

Here are the details:

Endpoint: GET https://api.keyapi.ai/v1/twitter/list_followers

Description: List followers

Required Headers:
--header 'Authorization: Bearer <YOUR_API_KEY>'

Parameters:
- list_id (Required): . Example: 1177128103228989440
- cursor (Optional): 

Example Response:
{
"code": 0,
"message": "success",
"data": {
"followers": [
  {
    "user_id": "1735774070",
    "screen_name": "MastaNed",
    "description": "Beriz-Beirut-NYC-Ldn | He/Lauiss | Performative Tweeter | Bâti pour les liens cubains | SalamGrandFrere™️",
    "profile_image": null,
    "statuses_count": 108938,
    "followers_count": 177,
    "friends_count": 281,
    "media_count": 3492,
    "created_at": "Fri Sep 06 17:32:24 +0000 2013",
    "location": "145ème & Largeroute",
    "blue_verified": false,
    "verified": false,
    "website": null,
    "name": "نهاد 💷",
    "affiliates": [],
    "business_account": null
  },
  {
    "user_id": "2020160576656203776",
    "screen_name": "jfrank9032",
    "description": "",
    "profile_image": null,
    "statuses_count": 0,
    "followers_count": 0,
    "friends_count": 1,
    "media_count": 0,
    "created_at": "Sat Feb 07 15:40:18 +0000 2026",
    "location": "",
    "blue_verified": false,
    "verified": false,
    "website": null,
    "name": "jfrank22",
    "affiliates": [],
    "business_account": null
  },
  {
    "user_id": "1961269400826515459",
    "screen_name": "tsxnjck",
    "description": "",
    "profile_image": null,
    "statuses_count": 337,
    "followers_count": 3,
    "friends_count": 112,
    "media_count": 2,
    "created_at": "Fri Aug 29 03:27:32 +0000 2025",
    "location": "",
    "blue_verified": false,
    "verified": false,
    "website": null,
    "name": "tsxn",
    "affiliates": [],
    "business_account": null
  },
  {
    "user_id": "3193672760",
    "screen_name": "KevMasangana",
    "description": "ingénieur BTP, Gérant de Dream Team Construction sarl",
    "profile_image": null,
    "statuses_count": 1149,
    "followers_count": 86,

... (truncated)`)}
    >
      <span>✨</span>
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml en/twitter.openapi.json GET /v1/twitter/list_followers
openapi: 3.0.1
info:
  title: Twitter/X API english documentation
  description: >-
    The english reference documentation of the Twitter/X API includes the
    interface's purpose, parameter description, response status, and sample
    structure.
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Twitter/X
security:
  - JWT Bearer: []
tags: []
paths:
  /v1/twitter/list_followers:
    get:
      tags: []
      summary: List followers
      parameters:
        - name: list_id
          in: query
          description: ''
          required: true
          example: '1177128103228989440'
          schema:
            type: string
            example: '1177128103228989440'
        - name: cursor
          in: query
          description: ''
          required: false
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  followers:
                    - user_id: '1735774070'
                      screen_name: MastaNed
                      description: >-
                        Beriz-Beirut-NYC-Ldn | He/Lauiss | Performative Tweeter
                        | Bâti pour les liens cubains | SalamGrandFrere™️
                      profile_image: null
                      statuses_count: 108938
                      followers_count: 177
                      friends_count: 281
                      media_count: 3492
                      created_at: Fri Sep 06 17:32:24 +0000 2013
                      location: 145ème & Largeroute
                      blue_verified: false
                      verified: false
                      website: null
                      name: نهاد 💷
                      affiliates: []
                      business_account: null
                    - user_id: '2020160576656203776'
                      screen_name: jfrank9032
                      description: ''
                      profile_image: null
                      statuses_count: 0
                      followers_count: 0
                      friends_count: 1
                      media_count: 0
                      created_at: Sat Feb 07 15:40:18 +0000 2026
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: jfrank22
                      affiliates: []
                      business_account: null
                    - user_id: '1961269400826515459'
                      screen_name: tsxnjck
                      description: ''
                      profile_image: null
                      statuses_count: 337
                      followers_count: 3
                      friends_count: 112
                      media_count: 2
                      created_at: Fri Aug 29 03:27:32 +0000 2025
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: tsxn
                      affiliates: []
                      business_account: null
                    - user_id: '3193672760'
                      screen_name: KevMasangana
                      description: ingénieur BTP, Gérant de Dream Team Construction sarl
                      profile_image: null
                      statuses_count: 1149
                      followers_count: 86
                      friends_count: 96
                      media_count: 15
                      created_at: Tue May 12 22:09:05 +0000 2015
                      location: Kinshasa, RDC
                      blue_verified: false
                      verified: false
                      website: null
                      name: Kevin Masangana
                      affiliates: []
                      business_account: null
                    - user_id: '1917648533324455936'
                      screen_name: bendasaissa23
                      description: ''
                      profile_image: null
                      statuses_count: 161
                      followers_count: 12
                      friends_count: 152
                      media_count: 21
                      created_at: Wed Apr 30 18:35:34 +0000 2025
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: Aissa Bendas
                      affiliates: []
                      business_account: null
                    - user_id: '376278076'
                      screen_name: Le_Kums
                      description: ''
                      profile_image: null
                      statuses_count: 26616
                      followers_count: 242
                      friends_count: 119
                      media_count: 366
                      created_at: Mon Sep 19 16:21:41 +0000 2011
                      location: Belgique
                      blue_verified: false
                      verified: false
                      website: null
                      name: Kayembé
                      affiliates: []
                      business_account: null
                    - user_id: '1708932252225110016'
                      screen_name: BImadeddin9931
                      description: ''
                      profile_image: null
                      statuses_count: 1
                      followers_count: 0
                      friends_count: 3
                      media_count: 0
                      created_at: Mon Oct 02 19:49:49 +0000 2023
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: Bouchemoukha imadeddine
                      affiliates: []
                      business_account: null
                    - user_id: '1894463741304958977'
                      screen_name: papito_laganny
                      description: ''
                      profile_image: null
                      statuses_count: 2
                      followers_count: 6
                      friends_count: 27
                      media_count: 0
                      created_at: Tue Feb 25 19:08:26 +0000 2025
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: Patrick Do_papito Laganny
                      affiliates: []
                      business_account: null
                    - user_id: '1686982680250884096'
                      screen_name: PascalCaid85
                      description: |-
                        Homme simple né le 27.03.1961 à Nantes.

                        1.83 m 67 kg  Gay
                      profile_image: null
                      statuses_count: 3822
                      followers_count: 48
                      friends_count: 68
                      media_count: 71
                      created_at: Thu Aug 03 06:10:30 +0000 2023
                      location: 'Je vis en Vendée 85 '
                      blue_verified: false
                      verified: false
                      website: null
                      name: Pascal
                      affiliates: []
                      business_account: null
                    - user_id: '1845768403283230733'
                      screen_name: thevoicewithinm
                      description: >-
                        The 1st media sharing:


                        😊 GOOD NEWS: Uplifting STORIES from everyday people!


                        🙌 LIFE CHANGING TOOLS: We all wish we had learned
                        sooner!


                        👇 3x a week: Monday,
                      profile_image: null
                      statuses_count: 34
                      followers_count: 16
                      friends_count: 126
                      media_count: 4
                      created_at: Mon Oct 14 10:07:49 +0000 2024
                      location: Los Angeles, CA
                      blue_verified: false
                      verified: false
                      website: https://linktr.ee/thevoicewithinmedia
                      name: thevoicewithinmedia
                      affiliates: []
                      business_account: null
                    - user_id: '1494053537390776329'
                      screen_name: o_danthon
                      description: ''
                      profile_image: null
                      statuses_count: 0
                      followers_count: 0
                      friends_count: 0
                      media_count: 0
                      created_at: Wed Feb 16 20:58:32 +0000 2022
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: Danthon Olivier
                      affiliates: []
                      business_account: null
                    - user_id: '1514218170315325444'
                      screen_name: insa_bisex54
                      description: ''
                      profile_image: null
                      statuses_count: 1
                      followers_count: 0
                      friends_count: 5
                      media_count: 0
                      created_at: Wed Apr 13 12:26:12 +0000 2022
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: liova
                      affiliates: []
                      business_account: null
                    - user_id: '1846544869009043456'
                      screen_name: Guerrillaz65
                      description: >-
                        "République des "Gueux" : outil de contrepouvoir
                        politique et culturel en création. A suivre.
                      profile_image: null
                      statuses_count: 112
                      followers_count: 327
                      friends_count: 3195
                      media_count: 23
                      created_at: Wed Oct 16 13:33:25 +0000 2024
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: laRépubliquedes"Gueux"
                      affiliates: []
                      business_account: null
                    - user_id: '1832655247853998080'
                      screen_name: PechonSylv74
                      description: >-
                        World'sMagicsHands est le Nom de ma Société, en passe de
                        voir le Jour. Praticienne, Magnétiseuse, Médium, je mets
                        des Mots sur vos Maux, pour un Bien-Être Total
                      profile_image: null
                      statuses_count: 132
                      followers_count: 22
                      friends_count: 165
                      media_count: 60
                      created_at: Sun Sep 08 06:00:27 +0000 2024
                      location: Cluses
                      blue_verified: false
                      verified: false
                      website: null
                      name: Sylvie PECHON
                      affiliates: []
                      business_account: null
                    - user_id: '1267195884497973249'
                      screen_name: yasshag
                      description: ''
                      profile_image: null
                      statuses_count: 830
                      followers_count: 4
                      friends_count: 118
                      media_count: 0
                      created_at: Sun May 31 20:47:06 +0000 2020
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: yass
                      affiliates: []
                      business_account: null
                    - user_id: '1568668660486512640'
                      screen_name: ThomasB66865717
                      description: ''
                      profile_image: null
                      statuses_count: 1
                      followers_count: 0
                      friends_count: 3
                      media_count: 0
                      created_at: Sat Sep 10 18:32:26 +0000 2022
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: Thomas Berger
                      affiliates: []
                      business_account: null
                    - user_id: '1784825604350627840'
                      screen_name: bony_pierr4767
                      description: ''
                      profile_image: null
                      statuses_count: 0
                      followers_count: 0
                      friends_count: 45
                      media_count: 0
                      created_at: Mon Apr 29 06:03:10 +0000 2024
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: Jean Pierre Bony
                      affiliates: []
                      business_account: null
                    - user_id: '1787923867878465537'
                      screen_name: TryumphMindset
                      description: 75k/mois 23 ans
                      profile_image: null
                      statuses_count: 159
                      followers_count: 23
                      friends_count: 120
                      media_count: 40
                      created_at: Tue May 07 19:14:29 +0000 2024
                      location: Monaco, France
                      blue_verified: false
                      verified: false
                      website: null
                      name: Triomphe MindSet 𝕏
                      affiliates: []
                      business_account: null
                    - user_id: '1791398521452568577'
                      screen_name: TMs983844121027
                      description: ''
                      profile_image: null
                      statuses_count: 5
                      followers_count: 0
                      friends_count: 8
                      media_count: 1
                      created_at: Fri May 17 09:21:42 +0000 2024
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: T Ms
                      affiliates: []
                      business_account: null
                    - user_id: '1790488997287841792'
                      screen_name: AntiTolisso
                      description: ici on va dire les termes, et ça risque de faire mal
                      profile_image: null
                      statuses_count: 3
                      followers_count: 2
                      friends_count: 27
                      media_count: 2
                      created_at: Tue May 14 21:07:04 +0000 2024
                      location: ''
                      blue_verified: false
                      verified: false
                      website: null
                      name: Polisso hating
                      affiliates: []
                      business_account: null
                  next_cursor: 1799064187879079521|2054445517814890474
                  status: ok
                  more_users: true
                requestId: 02622bf3-cdee-457b-8c1d-1b4bdb3631d0
          headers: {}
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: Missing required parameter
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 500
                  data: null
                  message: Internal server error
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/twitter/list_followers?list_id=1177128103228989440' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/twitter/list_followers',
                params={"list_id": "1177128103228989440"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"list_id":
            "1177128103228989440"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/twitter/list_followers?${params}`, {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
        Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).

````