Get Twitter profile
Looks up an X profile by handle.
Operation
/v1/twitter/profiles/{handle}Headers
API key (`sfk_...`)
Parameters
X handle to look up, with or without a leading @.
Response fields
Endpoint-specific response payload.
Whether the profile was found, private, or not found.
one of: found, private, not_found
Profile details when available.
Social platform for this profile.
one of: twitter
X screen name (handle) without the leading @.
Display name shown on the profile.
Profile biography text.
Best available square avatar image URL.
Profile banner image URL when available.
Whether X marks the profile with legacy verification (not necessarily paid blue).
Whether the account has X blue (paid) verification.
Canonical public profile URL on x.com.
min 1 chars
Whether the account is protected (private).
Numeric X user id (`rest_id`) as a string.
Account creation time as Unix epoch seconds when derivable.
≥ 0
Location string from the profile when provided.
Primary outbound link (expanded URL) from the profile.
Pinned tweet id when X exposes one.
Structured verification metadata from X.
Whether X marks the account as identity-verified.
When verification became effective, as milliseconds since epoch (string from X).
Verification reason payload when X provides it.
Human-readable verification reason text from X.
Inline entity metadata for the reason text (vendor-defined).
Tip jar configuration when present.
Whether the X tip jar is enabled.
Per-service handles when any are present.
Bandcamp handle from tip jar.
Bitcoin address or handle.
Cash App handle.
Ethereum address or handle.
GoFundMe handle.
Patreon handle.
PayPal handle.
Venmo handle.
Tweet highlights metadata when present.
Whether the account may highlight tweets on the profile.
Count of highlighted tweets when reported by X.
≥ 0
Opaque business-account payload from X when non-empty (vendor-defined).
Creator subscriptions count when X reports it.
≥ 0
Affiliate or business label when X provides one.
Affiliate or business label text shown on the profile.
Badge image URL when X provides one.
Destination URL for the label link.
Profile metrics when available.
Follower count from X.
≥ 0
Following (friends) count from X.
≥ 0
Total post (status) count from X.
≥ 0
Total favourites (likes) count from X.
≥ 0
Listed count when X provides it.
≥ 0
Media item count when X provides it.
≥ 0
Fast-followers count when X provides it.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Lookup result. Check `data.lookupStatus` for `found`, `private`, or `not_found`.
Error codes
Post comments
Lists top-level comments for a public Instagram post or reel URL with optional cursor-based pagination.
Profile tweets
Returns up to roughly 100 of the account's most popular public tweets as ranked by X. This is not a chronological timeline and is not paginated with a cursor. For handle resolution, inspect `data.lookupStatus` (`found` vs `not_found`). An empty `data.tweets` array can still accompany `lookupStatus: "found"` when the account resolves but has no eligible tweets in this set—call `GET /v1/twitter/profiles/{handle}` first if you need `private` vs `not_found` for the account itself.