Skip to main content
GET
Followers
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

user_id
string
required

The numeric user ID (rest_id) of the account to get followers for

Example:

"44196397"

cursor
string

Pagination cursor from a previous response to get the next page of results

Response

Successful response

Key Response Fields:

Pagination:

  • data.cursor.bottom: Pass as cursor query param to get the next page of followers
  • data.cursor.top: Cursor for the previous page

Timeline Structure:

  • data.result.timeline.instructions[0]: TimelineClearCache (internal, can ignore)
  • data.result.timeline.instructions[1]: TimelineTerminateTimeline direction Top
  • data.result.timeline.instructions[2]: TimelineTerminateTimeline direction Bottom — indicates no more results when present
  • data.result.timeline.instructions[3].entries[]: Array of follower entries (type TimelineAddEntries)

Each Follower (at entries[].content.itemContent.user_results.result):

  • .rest_id: User's numeric ID
  • .is_blue_verified: Whether user has a blue checkmark
  • .legacy.name: Display name
  • .legacy.screen_name: Handle (username without @)
  • .legacy.description: Bio
  • .legacy.followers_count: Follower count
  • .legacy.friends_count: Following count
  • .legacy.statuses_count: Total tweet count
  • .legacy.favourites_count: Total likes given
  • .legacy.media_count: Total media posts
  • .legacy.listed_count: Number of lists the user is on
  • .legacy.created_at: Account creation date
  • .legacy.location: Location set by user
  • .legacy.profile_image_url_https: Profile picture URL
  • .legacy.profile_banner_url: Banner image URL
  • .legacy.protected: Whether account is private
  • .legacy.verified: Legacy verified status
  • .professional.professional_type: Creator or Business (if applicable)