Twitter Followers API - Get a User's Followers

Fetch followers list

Retrieve follower accounts for a user with the same profile metadata shape as the following endpoint. An account that does not exist is a 404 user_not_found ("No X account with handle @x."), and so is a suspended one (the error says it is suspended); a 404 is final, not retryable, and not billed (2026-11-13; before, it was a retryable 503).

POST /followers Network
https://api.fetchlayer.dev/twitter/followers
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

handle string required

Twitter handle without @.

count integer optional

Accepted but has no effect: X sets the page size, about 50 to 70 accounts per page. Use nextCursor for more. (default: 25)

cursor string optional

Pagination cursor.

maxItems integer optional

Collect up to this many results in one call (1-500), following the pages for you. Each page of results returned bills one credit, and the last page comes back whole, so itemCount can exceed maxItems by less than a page. A call stops early at the end of the list or after about 90 seconds; hasMore and nextCursor then continue it. Leave it out for one page, billed one credit. Works with cursor and count.

timeoutMs integer optional

Time limit for the whole request, in milliseconds (1000–120000; values outside are brought into that range). It can only shorten the time a request may take, which is about 90 seconds at most. With maxItems, a call that runs out returns the pages it has, billed for those, with hasMore and nextCursor; a call with nothing to return yet fails with a 503 you can retry. We answer at the latest about 2 seconds before timeoutMs runs out (15% of it, at least 0.75 s, for limits under 13 seconds), so you can set it to your own client’s timeout. Left out, the request takes the time it needs.

Response Fields

followers

Fetch followers list

scrapedAt string

ISO 8601 time the result was produced.

transport string

The data source: always the platform id, "twitter".

listingType string

Which list this is, e.g. twitter-user-tweets.

itemCount integer

Number of items returned on this page.

nextCursor string | null

Pass as cursor, with the same other parameters, for the next page; null when there is none.

hasMore boolean

Whether more results follow: repeat the call with cursor set to nextCursor while it is true. Always present on followers, following and verified-followers; on the other lists, present with maxItems.

pagesFetched integer

With maxItems: the pages of results in this response, one credit each. Absent without maxItems (one page, one credit).

note string

With maxItems, why the call stopped before maxItems (the end of the list, or the time or page limit of one call, in which case hasMore is true and nextCursor continues). On search, also present when nothing was found.

user object | null

The account whose list this is, as user-profile-details returns it.

user.id string | null

Numeric account id, as a string. It stays the same when the handle changes.

user.name string | null

Display name.

user.handle string | null

Handle without the @.

user.description string | null

Bio text.

user.location string | null

Location as the account wrote it.

user.followersCount integer | null

Followers.

user.followingCount integer | null

Accounts followed.

user.tweetsCount integer | null

Posts, replies included.

user.mediaCount integer | null

Posts with media.

user.verified boolean | null

Whether the account carries a verification checkmark (see verification for which kind).

user.avatarUrl string | null

Profile image URL.

user.bannerUrl string | null

Header image URL, or null.

user.createdAt string | null

When the account was created, as X writes it: "Wed Dec 19 20:20:32 +0000 2007" (UTC).

user.favoritesCount integer | null

Posts the account has liked.

user.listedCount integer | null

Lists the account is on. Currently always null: X no longer sends it.

user.fastFollowersCount integer | null

Currently always null: X no longer sends it. Use followersCount.

user.normalFollowersCount integer | null

Currently always null: X no longer sends it. Use followersCount.

user.creatorSubscriptionsCount integer | null

Creator subscriptions the account has, or null when X leaves it out.

user.pinnedTweetIds string[]

Ids of the pinned posts; empty when none.

user.website object | null

The website link on the profile; null when there is none.

user.website.url string | null

The t.co short link.

user.website.expandedUrl string | null

The full address it leads to.

user.website.displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

user.descriptionUrls object[]

Links in the bio, expanded; empty when none.

user.descriptionUrls[].url string | null

The t.co short link.

user.descriptionUrls[].expandedUrl string | null

The full address it leads to.

user.descriptionUrls[].displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

user.avatarUrlLarge string | null

The profile image at 400x400.

user.verifiedType string | null

The kind of verification, e.g. Business or Government; null for none.

user.protected boolean | null

True when the account’s posts are visible to its followers only.

user.profileLabel object | null

The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.

user.profileLabel.description string | null

The badge’s label, e.g. the organisation’s name.

user.profileLabel.badgeUrl string | null

The badge image.

user.profileLabel.url string | null

Where the badge links to.

user.profileLabel.urlType string | null

X’s link type, e.g. DeepLink.

user.profileLabel.displayType string | null

How X shows it, e.g. Badge.

user.profileLabel.type string | null

X’s label type, e.g. BusinessLabel.

user.verification object

Which verification the account has.

user.verification.blue boolean | null

Verified through a subscription (the blue checkmark).

user.verification.verified boolean | null

Verified by X as notable (legacy verification).

user.verification.identityVerified boolean | null

The account holder’s identity was verified; null when X does not say.

user.verification.reason string | null

X’s own explanation of the checkmark, e.g. for a government account; null when it gives none.

profiles object[]

The accounts following this account.

profiles[].id string | null

Numeric account id, as a string. It stays the same when the handle changes.

profiles[].name string | null

Display name.

profiles[].handle string | null

Handle without the @.

profiles[].description string | null

Bio text.

profiles[].location string | null

Location as the account wrote it.

profiles[].followersCount integer | null

Followers.

profiles[].followingCount integer | null

Accounts followed.

profiles[].tweetsCount integer | null

Posts, replies included.

profiles[].mediaCount integer | null

Posts with media.

profiles[].verified boolean | null

Whether the account carries a verification checkmark (see verification for which kind).

profiles[].avatarUrl string | null

Profile image URL.

profiles[].bannerUrl string | null

Header image URL, or null.

profiles[].createdAt string | null

When the account was created, as X writes it: "Wed Dec 19 20:20:32 +0000 2007" (UTC).

profiles[].favoritesCount integer | null

Posts the account has liked.

profiles[].listedCount integer | null

Lists the account is on. Currently always null: X no longer sends it.

profiles[].fastFollowersCount integer | null

Currently always null: X no longer sends it. Use followersCount.

profiles[].normalFollowersCount integer | null

Currently always null: X no longer sends it. Use followersCount.

profiles[].creatorSubscriptionsCount integer | null

Creator subscriptions the account has, or null when X leaves it out.

profiles[].pinnedTweetIds string[]

Ids of the pinned posts; empty when none.

profiles[].website object | null

The website link on the profile; null when there is none.

profiles[].website.url string | null

The t.co short link.

profiles[].website.expandedUrl string | null

The full address it leads to.

profiles[].website.displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

profiles[].descriptionUrls object[]

Links in the bio, expanded; empty when none.

profiles[].descriptionUrls[].url string | null

The t.co short link.

profiles[].descriptionUrls[].expandedUrl string | null

The full address it leads to.

profiles[].descriptionUrls[].displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

profiles[].avatarUrlLarge string | null

The profile image at 400x400.

profiles[].verifiedType string | null

The kind of verification, e.g. Business or Government; null for none.

profiles[].protected boolean | null

True when the account’s posts are visible to its followers only.

profiles[].profileLabel object | null

The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.

profiles[].profileLabel.description string | null

The badge’s label, e.g. the organisation’s name.

profiles[].profileLabel.badgeUrl string | null

The badge image.

profiles[].profileLabel.url string | null

Where the badge links to.

profiles[].profileLabel.urlType string | null

X’s link type, e.g. DeepLink.

profiles[].profileLabel.displayType string | null

How X shows it, e.g. Badge.

profiles[].profileLabel.type string | null

X’s label type, e.g. BusinessLabel.

profiles[].verification object

Which verification the account has.

profiles[].verification.blue boolean | null

Verified through a subscription (the blue checkmark).

profiles[].verification.verified boolean | null

Verified by X as notable (legacy verification).

profiles[].verification.identityVerified boolean | null

The account holder’s identity was verified; null when X does not say.

profiles[].verification.reason string | null

X’s own explanation of the checkmark, e.g. for a government account; null when it gives none.

Request

curl -X POST "https://api.fetchlayer.dev/twitter/followers" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"handle":"NASA","count":20}'

Response

{
  "listingType": "twitter-followers",
  "user": {
    "id": "11348282",
    "name": "NASA",
    "handle": "NASA",
    "followersCount": 92312272,
    "verified": true
  },
  "itemCount": 1,
  "nextCursor": "1849213000000000000|2113790000000000000",
  "profiles": [
    {
      "id": "783214",
      "name": "X",
      "handle": "X",
      "description": "what’s happening?!",
      "followersCount": 68400000,
      "followingCount": 0,
      "verified": true,
      "avatarUrl": "https://pbs.twimg.com/profile_images/1683899100922511378/5lY42eHs_normal.jpg"
    }
  ],
  "scrapedAt": "2026-10-25T19:08:43.990Z",
  "transport": "twitter"
}
Product overview Twitter API: what it returns, pricing and use cases