Skip to content
OperationsX (Twitter)

List a profile's followers

The accounts that follow a profile on X (Twitter), the most recent first, each with its name, bio, counts and verification, read with your connected X account.

x/followers/list20 credits a callv1.0.0

When to use it

You want who follows an account on X: pass its handle (nasa, @nasa) or its profile's address. tab is the page's own: followers (the default), verified_followers (those with a check mark), or followers_you_know (those your connected account follows itself). Each account comes as x/profiles/get gives a profile. Follow next unchanged for more, 50 to 70 followers a page (20 for the two other tabs): the list goes further than x.com's own page shows, which stops scrolling after the first page. It ends on an empty answer, free. It needs one of your X accounts connected (POST /v2/accounts), and X counts each account's requests: about 50 pages of followers for 15 minutes. For the accounts a profile follows, use x/following/list.

It runs with one of your own X (Twitter) accounts, connected once: Accounts.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
The profile whose followers you want: its handle, with or without the @ (nasa, @nasa), or its address on x.com (https://x.com/nasa).
The tab of the followers' page: followers (every follower), verified_followers (the followers with a check mark), or followers_you_know (the followers your connected account follows: empty when it follows none of them).
The connected X account to read with (GET /v2/accounts).
Where to go on, from next in an answer, as it is: opaque, and only for the profile and tab it was given with (otherwise invalid_cursor).
20 credits a call
Code, from the fields above
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "x",
    "operation": "followers/list",
    "options": {
      "profile": "nasa"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_be3bpvwgaqccys5l5vgmagfwia",
  "livemode": true,
  "source": "x",
  "operation": "followers/list",
  "version": "1.0.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/x/followers/list",
  "options": {
    "profile": "nasa"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": false,
  "next": null,
  "cost": {
    "credits": 20
  },
  "results": [
    {
      "object": "profile",
      "id": "1700000000000000001",
      "position": 1,
      "handle": "maya_skywatch",
      "name": "Maya Chen",
      "url": "https://x.com/maya_skywatch",
      "description": "Amateur astronomer. Clear skies.",
      "description_language": "en",
      "description_urls": [],
      "location": "Tucson, AZ",
      "website_url": null,
      "created_at": "2023-09-05T14:21:08Z",
      "follower_count": 212,
      "following_count": 480,
      "tweet_count": 1930,
      "media_count": 164,
      "like_count": 5210,
      "is_blue_verified": false,
      "is_verified": false,
      "verified_type": null,
      "is_protected": false,
      "is_possibly_sensitive": false,
      "professional": null,
      "avatar_url": "https://pbs.twimg.com/profile_images/1700000000000000002/abcdEFGH_normal.jpg",
      "banner_url": null,
      "avatar_shape": "circle",
      "pinned_tweet_ids": [],
      "affiliation": null,
      "is_identity_verified": false,
      "verified_since": null,
      "verification_reason": null,
      "affiliate_count": null,
      "parody_label": null,
      "interstitial": null,
      "highlighted_tweet_count": 0,
      "subscription_count": 0,
      "has_hidden_subscriptions": false,
      "is_subscribable": false,
      "birthdate": null,
      "source_url": "https://x.com/nasa/followers",
      "observed_at": "2026-11-17T16:30:00Z"
    }
  ]
}

Options

profilestringrequired
The profile whose followers you want: its handle, with or without the @ (nasa, @nasa), or its address on x.com (https://x.com/nasa). Not its display name.
tab"followers" | "verified_followers" | "followers_you_know"Default followers
The tab of the followers' page: followers (every follower), verified_followers (the followers with a check mark), or followers_you_know (the followers your connected account follows: empty when it follows none of them).
accountstring
The connected X account to read with (GET /v2/accounts). Left out, the platform takes the first of your X accounts with a free slot.
cursorstring
Where to go on, from next in an answer, as it is: opaque, and only for the profile and tab it was given with (otherwise invalid_cursor). Leave it out to start at the most recent followers.

Record

Each record of results, in the envelope every call returns (Run an operation).

objectstring
idstring
The account's id: it stays when the handle changes.
positioninteger
Its rank in the list, across pages: 1 is the most recent follower.
handlestring
Its @handle, without the @, in the case the account wrote it.
namestring
The display name.
urlstring
The profile's page.
descriptionstring
The bio, as X gives it: its links are t.co addresses.
description_languagestring
The bio's language, as X detects it.
description_urlslist
The links of the bio
locationstring
As the account wrote it.
website_urlstring
The profile's link, in full.
created_atdate
When the account joined X.
follower_countinteger
following_countinteger
tweet_countinteger
Its posts, reposts and replies.
media_countinteger
Its tweets with a photo or a video.
like_countinteger
The tweets the account liked.
is_blue_verifiedboolean
The check mark next to the name, whatever its colour.
is_verifiedboolean
X's earlier verification.
verified_typestring
business (gold check) or government (grey check), when X says so.
is_protectedboolean
Whether only its followers see its posts.
is_possibly_sensitiveboolean
professional.typestring
business or creator.
professional.categorieslist
As X names them (Media Personality).
avatar_urlstring
banner_urlstring
avatar_shapestring
circle, square (organizations), hexagon.
pinned_tweet_idslist
The tweet pinned at the top of its posts.
is_identity_verifiedboolean
Whether X checked an identity document.
verified_sincedate
Since when it is verified; null when it is not, or when X writes a date outside the calendar.
verification_reasonstring
Why it is verified, in X's words, as the page writes it under the check mark.
affiliation.namestring
The organization's name on the badge.
affiliation.urlstring
The organization's profile, as X links it.
affiliation.badge_urlstring
The badge's image.
affiliation.typestring
business_label on every badge seen.
affiliate_countinteger
For an organization, the accounts affiliated to it; null for others.
parody_labelstring
parody, commentary or fan, when the account carries that label.
interstitialstring
The warning X puts before the profile, when any.
highlighted_tweet_countinteger
The tweets of its Highlights tab.
subscription_countinteger
The creators the account subscribes to.
has_hidden_subscriptionsboolean
Whether it hides them on its profile.
is_subscribableboolean
Whether the account sells subscriptions.
birthdate.dayinteger
birthdate.monthinteger
birthdate.yearinteger
Null when the profile hides the year.
source_urlstring
The list's page on x.com.
observed_atdate
When we read it.

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_profile422Pass a profile's handle (nasa, @nasa) or its address (https://x.com/nasa); tab is followers, verified_followers or followers_you_know.
profile_not_found404X has no profile with this handle (not charged).
profile_unavailable404X does not show this profile, suspended or withheld (not charged).
profile_protected403This profile is protected: X shows its followers to its own followers only, and your connected X account does not follow it (not charged).
account_required422You have no connected X account. Connect one with POST /v2/accounts {"site": "x", "cookies": ...}: the cookies of a browser where you are logged in to x.com (https://docs.lobstr.io/accounts).
account_rate_limited429This X account cannot read a list right now: it pauses a couple of seconds between two pages, and X counts each account's requests (about 50 pages of followers for 15 minutes). retry_after says when it can again, in seconds. Retrying before then gets this same answer: nothing is queued. Retryable.
account_unusable409X logged this account out, or locked it. Open x.com in the browser the account comes from, then connect it again with POST /v2/accounts and fresh cookies (the same account keeps its id).
site_unavailable503X did not answer properly; retry later (not charged). Retryable.
unexpected_answer424X answered in a shape we do not read yet; we are told and fix it (not charged).

Price

20 credits per call that returns accounts, a short page included. An empty answer (the call after the last page), a failed call and a busy account are free. What a credit costs on each plan: Credits and pricing.

Each connected account makes one call every 2 seconds, plus 0 to 2 seconds; a busy account answers at once with account_rate_limited and retry_after.

Changelog

1.0.02026-11-17
First version on the API v2, in place of the v1 Twitter Followers & Following Scraper's followers: a profile's followers, its verified followers or the followers you know, each as x/profiles/get gives a profile, page after page, read with your own connected X account.