Twitter Followers API

List the accounts that follow an X user, using its numeric user ID. Each follower includes the handle, display name, bio, location and follower and following counts. Page through the list with `cursor`.

Endpoint: POST /x/get-followers
Price: 1 credit per result
SDK: client.x.getFollowers()
MCP tool: x_get_followers

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/x/get-followers" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "userId": "44196397"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/x/get-followers",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "userId": "44196397",
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/x/get-followers", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "userId": "44196397"
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.x.getFollowers({
  userId: "44196397"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Twitter Followers API return?

Twitter followers API: export the followers of any X (Twitter) account, each with handle, name, bio, location and follower and following counts, as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

userIdstringrequired: Numeric user ID (rest_id) whose tweets to list, e.g. "44196397". Look it up from a handle with get-user.
cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "users": [
      {
        "userId": "string",
        "username": "string",
        "profileUrl": "string",
        "displayName": "string",
        "bio": "string",
        "avatarUrl": "string",
        "bannerUrl": "string",
        "location": "string",
        "websiteUrl": "string",
        "bioUrls": [
          {
            "url": "string",
            "displayUrl": "string"
          }
        ],
        "followerCount": 0,
        "followingCount": 0,
        "fastFollowersCount": 0,
        "normalFollowersCount": 0,
        "tweetCount": 0,
        "likeCount": 0,
        "mediaCount": 0,
        "listedCount": 0,
        "creatorSubscriptionsCount": 0,
        "highlightedTweetsCount": 0,
        "pinnedTweetId": "string",
        "pinnedTweetUrl": "string",
        "isVerified": true,
        "isBlueVerified": true,
        "verifiedType": "string",
        "isIdentityVerified": true,
        "isProtected": true,
        "canDm": true,
        "professionalType": "string",
        "professionalId": "string",
        "professionalCategoryId": 0,
        "professionalCategoryName": "string",
        "affiliate": {
          "label": "string",
          "username": "string",
          "profileUrl": "string",
          "badgeUrl": "string"
        },
        "tipJar": {
          "isEnabled": true,
          "bitcoinHandle": "string",
          "ethereumHandle": "string",
          "venmoHandle": "string",
          "venmoUrl": "string",
          "cashAppHandle": "string",
          "cashAppUrl": "string",
          "patreonHandle": "string",
          "patreonUrl": "string"
        },
        "createdAt": "2026-01-15T09:30:00.000Z"
      }
    ]
  }
}

[ USE CASES ]

What can you build with the Twitter Followers API?

Understand an audience

See who follows an account by bio, location and size.

Find prospects

Build a list from the followers of a competitor or community account.

Spot influencers

Sort followers by their own follower count to find the big voices.

[ FAQ ]

Twitter Followers API questions

How do I export a Twitter account’s followers?

Get the account’s numeric user ID from the Twitter User API and send it as userId. Page through the list with the cursor in each response; every follower comes with handle, display name, bio, location and follower and following counts.

How much does it cost to export 10,000 followers?

Followers are billed at 1 credit each, so 10,000 followers is 10,000 credits. Requests that fail cost nothing.

Can I analyze a competitor’s audience on X?

Yes. Pull their followers and look at bios, locations and follower counts to see who they reach and which followers have large audiences of their own.

How do I get a full list of someone’s Twitter followers?

Each call returns a page of usually 50 to 70 followers and a nextCursor. Send it back as cursor to get the next page; it is null once you reach the end of the list.

How do I use the Twitter Followers API?

Send a POST request to https://api.bridgly.app/x/get-followers with userId in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.x.getFollowers(). AI agents connected to Bridgly over MCP can call the x_get_followers tool.

How much does the Twitter Followers API cost?

Costs 1 credit per result returned, with a minimum of 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More X (Twitter) endpoints

The same API key works on every endpoint. See all X (Twitter) API endpoints.

Try the Twitter Followers API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs