CaptapiCaptapi
Twitter / X
GET /v1/twitter/profile

Twitter/X Profile API

X profile: verified + blue/legacy/identity, displayName, tipjar→contact{}, expanded website, createdAt.

1 credit per request
Try in PlaygroundGet your API key — freeRead the docs
TL;DR
X profile: verified + blue/legacy/identity, displayName, tipjar→contact{}, expanded website, createdAt. The Twitter/X Profile API (Twitter / X) is a single authenticated GET request to /v1/twitter/profile that responds with clean JSON and costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.

What is the Twitter/X Profile API?

Paste a profile URL or @handle and get clean JSON. Canonical profile core: platform, id, handle, url, displayName, bio, avatar, banner, followers, following, postCount, verified, createdAt — plus deprecated aliases username/name/profileImage/bannerImage/tweetCount for one release. Verification is three independent bits — isBlueVerified (paid blue), isLegacyVerified (old celebrity check), isIdentityVerified — plus aggregate verified (always present), verification{reason,verifiedSince,verifiedType}, and affiliate{description,url,badgeUrl}. Trust signals: fastFollowers / normalFollowers (X's own suspicious-follower split), possiblySensitive, withheldInCountries. Outreach: tipjarSettings + contact{emails,paymentHandles,links}, website as expanded URL (not raw t.co), and bioUrls[] with expandedUrl. Also listedCount, mediaCount, likesCount, pinnedTweetIds, highlightedTweets. Flat 1 credit. Pass cacheMaxAge=1d|3d|7d|14d|30d (envelope cached + cachedAt).

What you get

  • verified + isBlueVerified ≠ isLegacyVerified ≠ isIdentityVerified
  • displayName (+ name for compatibility)
  • contact{emails,paymentHandles,links} from tipjar + bio
  • website / bioUrls expanded (not t.co) + ISO createdAt

Try it

Open in Playground

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

Parameters

Sign in to run live
curl "https://api.captapi.com/v1/twitter/profile?url=https%3A%2F%2Fx.com%2FNASA" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Edit the parameters and the code updates instantly. Switch languages and hit copy.

Example response

{
  "success": true,
  "data": {
    "platform": "twitter",
    "url": "https://x.com/NASA",
    "id": "11348282",
    "username": "NASA",
    "displayName": "NASA",
    "name": "NASA",
    "bio": "Making the seemingly impossible, possible. ✨",
    "location": "Pale Blue Dot",
    "verified": true,
    "isBlueVerified": true,
    "isIdentityVerified": false,
    "verification": {
      "isBlueVerified": true,
      "isIdentityVerified": false,
      "verifiedType": "Government",
      "reason": "This account is verified because it is a government or multilateral organization account.  Learn more",
      "verifiedSince": "2009-08-07T19:53:50.000Z"
    },
    "followers": 92239064,
    "following": 119,
    "fastFollowers": 0,
    "normalFollowers": 92239064,
    "tweetCount": 74288,
    "likesCount": 16904,
    "mediaCount": 28058,
    "listedCount": 97014,
    "pinnedTweetIds": [
      "2082511887757881648"
    ],
    "website": "http://www.nasa.gov/",
    "contact": {
      "links": [
        "http://www.nasa.gov/"
      ]
    },
    "tipjarSettings": {
      "is_enabled": false
    },
    "profileImage": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
    "bannerImage": "https://pbs.twimg.com/profile_banners/11348282/1775567134",
    "profileImageShape": "Square",
    "possiblySensitive": false,
    "highlightedTweets": 265,
    "creatorSubscriptionsCount": 0,
    "businessAffiliatesCount": 89,
    "createdAt": "2007-12-19T20:20:32.000Z"
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Top-level fields

  • platformPlatform identifier for this response (matches the endpoint's platform).
  • urlCanonical URL of the item.
  • idStable platform ID for the item.
  • usernameAccount username / handle.
  • displayNameProfile display name (same concept as other platforms; name kept for compatibility).
  • nameName of the item or account. On profile endpoints: deprecated alias of displayName (one release).
  • bioProfile bio. Canonical across profile endpoints (prefer over description on YouTube).
  • locationLocation shown on the profile or item.
  • verifiedAggregate verification flag (blue, legacy, identity, or affiliate) — always present.
  • isBlueVerifiedWhether the account has blue-check verification.
  • isIdentityVerifiedIs identity verified. Example: false.
  • followersFollower count.
  • followingNumber of accounts followed.
  • fastFollowersFast followers. Example: 0.
  • normalFollowersNormal followers. Example: 92239064.
  • tweetCountTotal number of tweets.
  • likesCountLikes count. Example: 16904.
  • mediaCountTotal number of media posts.
  • listedCountListed count. Example: 97014.
  • pinnedTweetIdsPinned tweet ids (array).
  • websiteWebsite listed on the profile.
  • profileImageProfile image URL. Deprecated alias of avatar on Instagram/Twitter/Threads/TikTok profile endpoints (one release).
  • bannerImageBanner image URL. Deprecated alias of banner on Twitter (one release).
  • profileImageShapeProfile image shape. Example: "Square".
  • possiblySensitivePossibly sensitive. Example: false.
  • highlightedTweetsHighlighted tweets. Example: 265.
  • creatorSubscriptionsCountCreator subscriptions count. Example: 0.
  • businessAffiliatesCountBusiness affiliates count. Example: 89.
  • createdAtCreation date (ISO 8601).

Verification

The verification object contains:

  • isBlueVerifiedWhether the account has blue-check verification.
  • isIdentityVerifiedIs identity verified. Example: false.
  • verifiedTypeVerified type. Example: "Government".
  • reasonReason.
  • verifiedSinceVerified since. Example: "2009-08-07T19:53:50.000Z".

Contact

The contact object contains:

  • linksLinks listed on the page.

Tipjar settings

The tipjarSettings object contains:

  • is_enabledIs enabled. Example: false.

Parameters

NameTypeRequiredDescription
urlstringYesTwitter/X profile URL or @handle, e.g. https://x.com/username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
cachebooleanNoSet true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits.
cacheMaxAgestringNoMax age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL (SC cache_max_age). Envelope: cached + cachedAt.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh.

Using an AI agent? This endpoint is the MCP tool twitter_profile via @captapi/mcp. Set it up →

How it works

  1. 1. Sign up — get 100 free credits, no card required.
  2. 2. Create a key from your dashboard.
  3. 3. Send one request to /v1/twitter/profile and parse the JSON response.

Use cases

Profile Enrichment

Add live stats, bio, and account flags to a contact you already have.

Creator Verification

Confirm a known handle, audience size, and business/verified status before outreach.

Competitive Analysis

Track follower growth and posting cadence for accounts you already follow.

Partnership Qualification

Vet known partnership and sponsorship targets with fresh profile data.

Frequently asked questions

What does the Twitter/X Profile API do?+

The Twitter/X Profile API lets you fetch profile or page details and audience stats from a public Twitter / X profile or page using one GET request to /v1/twitter/profile. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Twitter/X Profile API cost?+

Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Twitter / X API key or OAuth?+

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the Twitter/X Profile API suitable for production use?+

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

More Twitter / X APIs

Twitter/X Tweet Details APITwitter/X Transcript APITwitter/X User Tweets APITwitter/X Community APITwitter/X Community Tweets API

Ready to use the Twitter/X Profile API?

Sign up, grab your key, and make your first call in 60 seconds.

Get started free