Get multiple Twitter profiles
Get up to 50 X profiles in one request by handles and/or numeric user ids.
Headers
Get your API keyAPI key (`sfk_...`)
X (Twitter) profile handle without the leading @. Repeat this parameter for multiple handles.
Numeric X (Twitter) user id. Repeat this parameter for multiple ids.
Endpoint-specific response payload.
Per-request profile lookup results, in the same order as the request (handles then ids). Duplicates are not removed.
Requested handle or numeric user id echoed for this row.
min 1 chars
Whether this row was requested as a handle or a numeric user id.
one of: handle, id
Whether this profile was resolved.
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 as a string.
Account creation time (ISO-8601) when derivable.
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.
Whether X marks the account as blue-verified. Same signal as `blueVerified`.
X verification type label when provided (for example a government or organization note).
Pinned tweet ids from X, in display order.
Total likes (favorites) on the profile. Prefer `metrics.favourites`.
≥ 0
Account creation time as returned by X (raw upstream string). Prefer `accountCreatedAt` for ISO-8601.
X professional-account metadata when the account is marked professional.
Professional account type from X, when present.
Professional category entries from X.
Professional account rest id from X, when present.
Country codes where the profile is withheld.
Avatar crop shape reported by X, such as Circle or Square.
When X verification became effective (ISO-8601). Invalid dates are null. Prefer this over `verificationInfo.verifiedSinceMsec`.
Whether X marks the profile as possibly sensitive.
Interstitial type shown on the profile when X reports one.
Whether creator subscriptions are hidden on the profile.
Whether X reports graduated access for this account.
Whether X considers the profile text translatable.
Whether the account has custom timelines.
Whether X marks the account as a translator.
Whether the account still uses the default profile theme.
Whether the account still uses the default avatar.
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
Summary counts for the profile batch.
Number of handles and ids requested in this batch.
≥ 0
Number of public profiles successfully found.
≥ 0
Number of profiles that were not found.
≥ 0
Number of profiles that are protected (private).
≥ 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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/twitter/profiles" \
-H "x-api-key: YOUR_API_KEY"Responses
Twitter profile batch lookup results.