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.0When 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.
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.
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" } }'
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
profilestringrequiredtab"followers" | "verified_followers" | "followers_you_know"Default followersaccountstringcursorstringnext 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).
objectstringidstringpositionintegerhandlestringnamestringurlstringdescriptionstringdescription_languagestringdescription_urlslistlocationstringwebsite_urlstringcreated_atdatefollower_countintegerfollowing_countintegertweet_countintegermedia_countintegerlike_countintegeris_blue_verifiedbooleanis_verifiedbooleanverified_typestringis_protectedbooleanis_possibly_sensitivebooleanprofessional.typestringprofessional.categorieslistavatar_urlstringbanner_urlstringavatar_shapestringpinned_tweet_idslistis_identity_verifiedbooleanverified_sincedateverification_reasonstringaffiliation.namestringaffiliation.urlstringaffiliation.badge_urlstringaffiliation.typestringaffiliate_countintegerparody_labelstringinterstitialstringhighlighted_tweet_countintegersubscription_countintegerhas_hidden_subscriptionsbooleanis_subscribablebooleanbirthdate.dayintegerbirthdate.monthintegerbirthdate.yearintegersource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_profile | 422 | Pass a profile's handle (nasa, @nasa) or its address (https://x.com/nasa); tab is followers, verified_followers or followers_you_know. |
profile_not_found | 404 | X has no profile with this handle (not charged). |
profile_unavailable | 404 | X does not show this profile, suspended or withheld (not charged). |
profile_protected | 403 | This profile is protected: X shows its followers to its own followers only, and your connected X account does not follow it (not charged). |
account_required | 422 | You 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_limited | 429 | This 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_unusable | 409 | X 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_unavailable | 503 | X did not answer properly; retry later (not charged). Retryable. |
unexpected_answer | 424 | X 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