Get a profile
A profile on X (Twitter) by its handle: its name, bio, links, follower and tweet counts, verification, affiliation and images, read with your connected X account.
x/profiles/get1 credit a callv1.0.0When to use it
You want who an account on X is and how big: pass its handle (nasa, @nasa) or its profile's address. One call, one profile. A protected profile is given as any other (is_protected): only its posts are kept from those who do not follow it. It needs one of your X accounts connected (POST /v2/accounts), and X counts each account's requests: about 150 profiles for 15 minutes. For what the account posts, use x/tweets/list with the same handle.
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": "profiles/get", "options": { "profile": "nasa" } }'
An example answer, from the contract. Run it on your own input with your API key.
{ "object": "run", "id": "run_k6utvrozzq4rto4t6cvlf23tuy", "livemode": true, "source": "x", "operation": "profiles/get", "version": "1.0.0", "schema_url": "https://api.lobstr.io/v2/catalog/x/profiles/get", "options": { "profile": "nasa" }, "fields": null, "status": "succeeded", "count": 1, "has_more": false, "next": null, "cost": { "credits": 1 }, "results": [ { "object": "profile", "id": "11348282", "handle": "NASA", "name": "NASA", "url": "https://x.com/NASA", "description": "Making the seemingly impossible, possible. ✨", "description_language": "en", "description_urls": [], "location": "Pale Blue Dot", "website_url": "http://www.nasa.gov/", "created_at": "2007-12-19T20:20:32Z", "follower_count": 92233097, "following_count": 115, "tweet_count": 74544, "media_count": 28250, "like_count": 17111, "is_blue_verified": true, "is_verified": false, "verified_type": "government", "is_protected": false, "is_possibly_sensitive": false, "professional": null, "avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg", "banner_url": "https://pbs.twimg.com/profile_banners/11348282/1788992290", "avatar_shape": "square", "pinned_tweet_ids": [], "affiliation": null, "is_identity_verified": false, "verified_since": "2009-08-07T19:53:50Z", "verification_reason": "This account is verified because it is a government or multilateral organization account. Learn more", "affiliate_count": 85, "parody_label": null, "interstitial": null, "highlighted_tweet_count": 292, "subscription_count": 0, "has_hidden_subscriptions": false, "is_subscribable": false, "birthdate": { "day": 1, "month": 10, "year": 1958 }, "observed_at": "2026-11-17T15:00:00Z" } ] }
Options
profilestringrequiredaccountstringRecord
Each record of results, in the envelope every call returns (Run an operation).
objectstringidstringhandlestringnamestringurlstringdescriptionstringdescription_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.yearintegerobserved_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). |
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). |
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 profile right now: it pauses a couple of seconds between two profiles, and X counts each account's requests (about 150 profiles 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
1 credit per call that returns the profile. A failed call (no such profile, a suspended one) 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