v1

latestOpenAPI 3.0.1MIT2026-07-26589101.4 KB

Get user followings (with full profile metadata). Sorted by follow date — most recent followings appear on the first page. Use cursor for pagination.

Tiered pricing (per following returned)

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

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

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

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

get/twitter/user/followings

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 followings

has_next_pageboolean

Indicates if there are more results available

next_cursorstring

Cursor for fetching the next page of results

status'success' | 'error'

Status of the request.success or error

messagestring

Message of the request.error message