Skip to main content
GET
/
twitter
/
user
/
followers_ids
cURL
curl --request GET \
  --url https://api.twitterapi.io/twitter/user/followers_ids \
  --header 'X-API-Key: <api-key>'
{
  "ids": [
    "<string>"
  ],
  "has_next_page": true,
  "next_cursor": "<string>",
  "status": "success",
  "msg": "<string>",
  "code": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.twitterapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
userName
string<string>

Screen name of the user (e.g. elonmusk). Either userName or userId is required.

​
userId
string<string>

Numeric user ID. Either userName or userId is required.

​
count
integer
default:5000

Number of follower IDs to return per page. Min 50, max 5000. Default 5000 (bulk pull, recommended).

Required range: 50 <= x <= 5000
​
cursor
string<string>

Pagination cursor — pass the next_cursor value from the previous response. First page: omit or pass empty string.

Response

Follower IDs

​
ids
string[]

Array of follower IDs.

Numeric Twitter user ID, returned as string to preserve precision (Twitter IDs exceed JS Number safe range).

​
has_next_page
boolean

True if more pages are available (next_cursor is non-empty and not '0').

​
next_cursor
string

Cursor for the next page. Empty string or '0' means no more pages.

​
status
enum<string>

Status of the request — 'success' or 'error'.

Available options:
success,
error
​
msg
string

Status message.

​
code
integer

Status code (0 = success).