Skip to content
X (Twitter)

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.0

When 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.

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: its handle, with or without the @ (nasa, @nasa), or its address on x.com (https://x.com/nasa).
The connected X account to read with (GET /v2/accounts).
1 credit 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": "profiles/get",
    "options": {
      "profile": "nasa"
    }
  }'
2Response

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

profilestringrequired
The profile: its handle, with or without the @ (nasa, @nasa), or its address on x.com (https://x.com/nasa). Not its display name.
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.

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.
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.
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).
profile_not_found404X has no profile with this handle (not charged).
profile_unavailable404X does not show this profile, suspended or withheld (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 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_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

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
First version on the API v2, in place of the v1 Twitter Profile Scraper: a profile by its handle or its address, with its counts, verification, affiliation, professional profile and images, read with your own connected X account.