Skip to content
cheapxapi
All endpoints

Get followers

GET/twitter/user/followers

Followers of a user with full profiles. Up to 100 per page. Paginated: use cursor / next_cursor.

Price: $0.0006 per request.

Parameters

  • userNamestringrequired

    Screen name without the @, e.g. NASA.

    Example: NASA

  • cursorstring

    Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response.

  • pageSizeinteger (20 to 100)

    Items per page, 20 to 100 (default 100). Larger values are treated as 100, smaller as 20.

    Example: 100

Example request

curl "https://api.cheapxapi.com/twitter/user/followers?userName=NASA" \
  -H "x-api-key: YOUR_KEY"

Response

Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.

FieldType
followersarray of UserProfileSnake
idstring
namestring
screen_namestring
userNamestring
usernamestring
locationstring
urlstring
descriptionstring
emailstring
protectedboolean
verifiedboolean
isBlueVerifiedboolean
followers_countinteger
following_countinteger
friends_countinteger
favourites_countinteger
statuses_countinteger
media_tweets_countinteger
created_atstring
profile_banner_urlstring
profile_image_url_httpsstring
can_dmboolean
status"success" | "error"
msgstring
has_next_pageboolean
next_cursorstring
codeinteger

Status codes

200
Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.
400
Invalid parameters (charged), or API key placed in the URL (not charged).
401
Missing or invalid API key (not charged).
402
Insufficient balance (not charged).
403
Account disabled (not charged).
404
Unknown endpoint (charged), or the requested item could not be found (not charged). Note: many endpoints report a missing user/tweet as HTTP 200 with "status":"error" instead; those are charged.
405
Only GET is supported (not charged).
429
Rate limit exceeded (not charged). Retry after the time in the Retry-After header.
503
Temporary service problem, or the endpoint is temporarily unavailable (not charged). Retry with exponential backoff.