# Verified followers

`GET https://api.twittrapi.com/user/{userId}/verifiedFollowers`

Followers of a user that have a verified (blue) badge.

HTML page: https://www.twittrapi.com/docs/reference/user-userid-verifiedfollowers

## Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `userId` | path | string | yes |  | Numeric user ID (digits only, up to 30). To pass a handle instead, use -1 here and set username. |
| `username` | query | string | no |  | Handle, with or without @. When set, it is used instead of userId: the API looks up the ID first, which makes the call a little slower. Still one billed call. |
| `count` | query | integer | no | 20 | Number of items to ask X for. Sent to X as is; X treats it as a hint and decides how many it returns (follower and following pages often hold 50 to 70 users for count=20). A value that is not a number falls back to 20. |
| `cursor` | query | string | no |  | Bottom cursor from the previous page. Leave it out for the first page. See Pagination. |

Every read endpoint also accepts `format=simple` (or the header `X-Response-Format: simple`) for compact, flat JSON with a fixed schema. Same price.

Paginated: pass the bottom cursor of one page as `cursor` to get the next. Each page is one billed call.

## Response

Raw JSON of X's BlueVerifiedFollowers query.

With `format=simple`: Collection of User objects: {data: [User], nextCursor, previousCursor, hasNextPage}.

## Errors

| Status | When |
| --- | --- |
| 422 | userId is not numeric, or the username lookup failed. |
| 400 | userId is -1 and username is missing, the username contains characters X blocks, or the user could not be found. |

Shared errors (401 missing key, 402 no balance, 429 rate limit, 5xx) are listed on https://www.twittrapi.com/docs/helpful-infos/error-handling. Calls that fail with 400, 408, 409 or a 5xx error are refunded.

## Example request

curl:

```bash
curl 'https://api.twittrapi.com/user/12/verifiedFollowers?count=20' \
  --header 'X-API-KEY: YOUR_API_KEY'
```

Python:

```python
from twittrapi import TwittrAPI

client = TwittrAPI(api_key="YOUR_API_KEY")
data = client.users.verified_followers("12", count=20)
```

Node.js:

```js
import { TwittrAPI } from "twittrapi";

const client = new TwittrAPI({ apiKey: process.env.TWITTRAPI_API_KEY });
const data = await client.users.verifiedFollowers({ userId: "12", count: 20 });
```

RapidAPI:

```bash
curl 'https://twitter-aio.p.rapidapi.com/user/12/verifiedFollowers?count=20' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY' \
  --header 'x-rapidapi-host: twitter-aio.p.rapidapi.com'
```

## Example response

Shortened: arrays keep their first items and long strings are cut.

Raw (default):

```json
{
  "data": {
    "user": {
      "result": {
        "__typename": "User",
        "timeline": {
          "timeline": {
            "instructions": [
              {
                "type": "TimelineClearCache"
              },
              {
                "direction": "Top",
                "type": "TimelineTerminateTimeline"
              },
              {
                "entries": [
                  {
                    "content": {
                      "__typename": "TimelineTimelineItem",
                      "clientEventInfo": {
                        "component": "BlueVerifiedFollowersSgs",
                        "element": "user"
                      },
                      "entryType": "TimelineTimelineItem",
                      "itemContent": {
                        "__typename": "TimelineUser",
                        "itemType": "TimelineUser",
                        "userDisplayType": "User",
                        "user_results": {
                          "result": {
                            "__typename": "User",
                            "affiliates_highlighted_label": {
                              "…": "…"
                            },
                            "avatar": {
                              "…": "…"
                            },
                            "core": {
                              "…": "…"
                            },
                            "dm_permissions": {
                              "…": "…"
                            },
                            "has_graduated_access": true,
                            "id": "VXNlcjoxMDAwMDAwMDAwMDAwMDAwMDAx",
                            "is_blue_verified": true,
                            "legacy": {
                              "…": "…"
                            },
                            "location": {
                              "…": "…"
                            },
                            "media_permissions": {
                              "…": "…"
                            },
                            "parody_commentary_fan_label": "None",
                            "privacy": {
                              "…": "…"
                            },
                            "profile_image_shape": "Circle",
                            "relationship_perspectives": {
                              "…": "…"
                            },
                            "rest_id": "1000000000000000001",
                            "super_follow_eligible": false,
                            "super_followed_by": false,
                            "super_following": false,
                            "tipjar_settings": {
                              "…": "…"
                            },
                            "verification": {
                              "…": "…"
                            }
                          }
                        }
                      }
                    },
                    "entryId": "user-1000000000000000001",
                    "sortIndex": "2109014682063863805"
                  },
                  "… 3 more"
                ],
                "type": "TimelineAddEntries"
              },
              "… 1 more"
            ]
          }
        }
      }
… (3 more lines)
```

Simple (`format=simple`):

```json
{
  "data": [
    {
      "id": "1000000000000000001",
      "username": "example_user_1",
      "name": "Example User 1",
      "description": "",
      "location": "",
      "url": "https://example.com",
      "createdAt": "2017-08-24T11:24:32Z",
      "avatarUrl": "https://pbs.twimg.com/profile_images/1000000000000000000/example.jpg",
      "bannerUrl": "https://pbs.twimg.com/profile_banners/1000000000000000000/1700000000",
      "verified": true,
      "verifiedType": null,
      "protected": false,
      "counts": {
        "followers": 56,
        "following": 236,
        "tweets": 12,
        "likes": 1418,
        "media": 0,
        "listed": 0
      },
      "pinnedTweetIds": [],
      "isAutomated": false
    },
    "… 1 more"
  ],
  "nextCursor": "1000000000000000000|2109014682063863786",
  "previousCursor": null,
  "hasNextPage": true
}
```