Accounts & creatorsX (Twitter / 推特)Follower ID · List

X bulk follower IDs

Read a lightweight, cursor-paginated batch of follower IDs for a public account.

POST/v1/x/users/follower-ids

Chinese name: X 粉丝 ID 批量列表 · 粉丝 ID · 列表批量读取一个公开账号的轻量粉丝 ID。
x.users.follower.ids@v1

Price per call

¥0.01/ call

Complete and confirmed empty results are charged; partial results and failures are not.

AvailableChecking live status →

Checking live status

Try it

Request JSON body

Security check

Loading the security check…

6-digit code

Checking live execution status…

Execution result

// Result

Request parameters

user_namestringoptional

pattern: "^@?[A-Za-z0-9_]+$" · minLength: 1 · maxLength: 64

Example: "OpenAI"

user_idstringoptional

pattern: "^[0-9]{1,20}$"

countintegeroptional

default: 5000 · minimum: 50 · maximum: 5000

Example: 50

cursorstringoptional

minLength: 1

Request JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "user_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^@?[A-Za-z0-9_]+$"
    },
    "user_id": {
      "type": "string",
      "pattern": "^[0-9]{1,20}$"
    },
    "count": {
      "default": 5000,
      "type": "integer",
      "minimum": 50,
      "maximum": 5000
    },
    "cursor": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/x/users/follower-ids \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"user_name":"OpenAI","count":50}'

import { ExactApiClient } from "@dataxapi/sdk";

const client = new ExactApiClient({
  baseUrl: "https://api.dataxapi.com",
  apiKey: process.env.DATAXAPI_API_KEY,
});

const result = await client.call("x_users_follower_ids_v1", {
  "user_name": "OpenAI",
  "count": 50
});
console.log(result.data);

import os
from dataxapi import ExactApiClient

client = ExactApiClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])

result = client.call("x_users_follower_ids_v1", {
    "user_name": "OpenAI",
    "count": 50,
})
print(result["data"])

[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"

Response example

200 · application/json

{
  "code": 200,
  "request_id": "req_example_x_users_follower_ids",
  "message": "success",
  "data": {
    "items": [
      "1354563317885521920",
      "1436145063038369812"
    ]
  },
  "page": {
    "next_cursor": "opaque_cursor_example"
  },
  "warnings": [],
  "meta": {
    "listing_id": "x.users.follower.ids",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.01",
    "balance_after": "1.00",
    "currency": "CNY"
  }
}

Response fields

codenumber: const: 200
request_idstring
messagestring: const: "success"
dataobject
pageobject
warningsarray
metaobject

Response JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[0-9]{1,20}$"
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "x.users.follower.ids"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

Use it when you need lightweight follower identifiers for a public account and will fetch profiles separately.

Not for

Do not use it when you need profile fields, a complete historical follower snapshot, or private relationships.

Known limitations

Exactly one username or numeric user ID is required.
The page size is between 50 and 5,000 IDs.
The price is fixed per call regardless of how many IDs the page returns.

Billing

¥0.01 per call. Complete and confirmed empty results are charged; partial results and failures are not.

See all pricing →