Twitter Following API

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

Endpoint: POST /x/get-following
Price: 1 credit per result
SDK: client.x.getFollowing()
MCP tool: x_get_following

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/x/get-following" \
  -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-following",
    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-following", {
  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.getFollowing({
  userId: "44196397"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Twitter Following API return?

Twitter following API: list the accounts any X (Twitter) user follows, 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 Following API?

Map interests

See which people and brands an account chooses to follow.

Discover sources

Find the accounts experts in your field rely on.

Track new follows

Compare lists over time to see who an investor or founder just followed.

[ FAQ ]

Twitter Following API questions

How do I see who a Twitter user follows?

Get the account’s numeric user ID from the Twitter User API and send it as userId. Each followed account comes with handle, display name, bio, location and follower and following counts; send the cursor for the next page.

What can a following list tell me?

Who an investor, founder or creator follows shows what they pay attention to. Comparing several lists surfaces the accounts a whole niche follows.

How do I get the full list of accounts someone follows?

Each call returns a page of usually 50 to 70 accounts 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 Following API?

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

How much does the Twitter Following 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 Following 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