X / Twitter Followers

Follower list of a public X (Twitter) account with bio, counts and avatar per follower, cursor-paged up to 200 per page.

2 credits/ call

Never more than 9 credits a call.

Try it in the Playground

You only pay when data comes back.

curl -X POST "https://api.primaryapi.com/v1/run/twitter.followers" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"nasa"}'

const res = await fetch('https://api.primaryapi.com/v1/run/twitter.followers', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PRIMARYAPI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ username: 'nasa' }),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.code}: ${body.error}`);

// found: false means "does not exist" and is still a success.
console.log(body.output.data, body.credits);

import os
import requests

res = requests.post(
    "https://api.primaryapi.com/v1/run/twitter.followers",
    headers={"Authorization": f"Bearer {os.environ['PRIMARYAPI_API_KEY']}"},
    json={"username": "nasa"},
    timeout=60,
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['code']}: {body['error']}")

print(body["output"]["data"], body["credits"])

// MCP server: https://api.primaryapi.com/mcp (Streamable HTTP)
// Auth header: Authorization: Bearer $PRIMARYAPI_API_KEY
// The tool call your agent makes:
{
  "name": "run_api",
  "arguments": {
    "sku": "twitter.followers",
    "input": {
      "username": "nasa"
    }
  }
}

Response · field types200 · 2 credits

{
  "output": {
    "found": true,
    "data": {
      "nextCursor": "<string | null>",
      "items": [
        {
          "username": "<string | null>",
          "name": "<string | null>",
          "followers": "<integer | null>",
          "verified": "<boolean | null>", …
        }
      ]
    }
  },
  "credits": 2
}

Input and output

One username in. A page of followers out.

Input. What you send.

3 fields

usernameRequired: The X (Twitter) username to fetch followers for, without the @ prefix (e.g. nasa). For example nasa.
limit: Accepted for compatibility: each call returns one native page, never trimmed; follow nextCursor.
cursor: Opaque pagination cursor: pass the previous response's nextCursor.

Output. What comes back, per follower.

11 fields

username: Screen name without @
name: Text.
bio: Text.
followers: A whole number.
verified: True or false.
id: Numeric user id (string)
nextCursor: Pass back as cursor for the next page; null at the end

All 11 fields in the API reference

Good to know

Three things to know before you call.

Follower lists are bulk personal data. Customers carry lawful-use responsibility.
One page per call. Send nextCursor back as cursor to read the next page.
Unknown username? It comes back as not found, not as an error.

More from X / Twitter. Same key, same credits.

All 10 X / Twitter APIs

Get X / Twitter data with one key.

Get an API key Try it in the Playground

The same key and credits work for every API.

import os import requests res = requests.post( "https://api.primaryapi.com/v1/run/twitter.followers", headers={"Authorization": f"Bearer {os.environ['PRIMARYAPI_API_KEY']}"}, json={"username": "nasa"}, timeout=60, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['code']}: {body['error']}") print(body["output"]["data"], body["credits"])

// MCP server: https://api.primaryapi.com/mcp (Streamable HTTP) // Auth header: Authorization: Bearer $PRIMARYAPI_API_KEY // The tool call your agent makes: { "name": "run_api", "arguments": { "sku": "twitter.followers", "input": { "username": "nasa" } } }

{ "output": { "found": true, "data": { "nextCursor": "<string | null>", "items": [ { "username": "<string | null>", "name": "<string | null>", "followers": "<integer | null>", "verified": "<boolean | null>", … } ] } }, "credits": 2 }