v1

latestOpenAPI 3.0.1MIT2026-07-26589101.4 KB

Get user followers (with full profile metadata) in reverse chronological order (newest first). Sorted by follow date — most recent followers appear on the first page. Use cursor for pagination through the complete followers list.

Tiered pricing (per follower returned)

Credits ↔ USD: 100,000 credits = $1.00 (1 credit ≈ $0.00001)

Returned followers per callPriceUSD equivalent
200 (max page size)1 credit / follower$0.01 / 1k followers
100 - 1992 credits / follower$0.02 / 1k followers
20 - 993 credits / follower$0.03 / 1k followers

💡 At max page size, 100,000 follower profiles cost just $1.00.

Minimum charge: 60 credits ($0.0006) per call (20 followers × 3 credits, the smallest page size).

For pure follower-ID collection at scale, see the cheaper /twitter/user/followers_ids endpoint — no profile metadata, up to 5,000 IDs per call, as low as $0.0045 per 1,000 IDs at the bulk tier.

get/twitter/user/followers

Query parameters

userNamestring string required

screen name of the user

cursorstring string

The cursor to paginate through the results. First page is "".

pageSizeinteger

The number of followings to return per page. Default is 200.min 20,max 200

Response

User info

status'success' | 'error'

Status of the request.success or error

messagestring

Message of the request.error message