Get Threads profile
Looks up a Threads profile by handle. Outcomes such as found, private, or not found are indicated in `data.lookupStatus`.
Operation
/v1/threads/profiles/{handle}Headers
API key (`sfk_...`)
Parameters
Threads handle to look up, with or without a leading @.
min 1 chars · max 64 chars
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: threads
Threads username without the leading @.
Public display name shown on the Threads profile.
Profile biography text.
Best available avatar image URL for the profile.
Whether the profile is marked as verified.
Canonical public Threads profile URL.
min 1 chars
Whether the Threads account is private.
Threads profile id as a string when available.
Whether the account is marked as a Threads-only profile.
Structured bio links when available.
Destination URL for the profile link.
min 1 chars
Whether the profile link is marked as verified.
Stable link identifier when available.
Avatar image versions when available.
Avatar image URL.
min 1 chars
Avatar image width in pixels when available.
≥ 0
Avatar image height in pixels when available.
≥ 0
Profile metrics when available.
Follower count for the profile when available.
≥ 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
Video transcript
Returns structured captions for a YouTube video when available. Pass `url` as a standard watch link (or equivalent). Optional `language` requests a preferred caption language when multiple tracks exist.
Profile posts
Returns recent public posts for a Threads handle. For handle resolution, inspect `data.lookupStatus` (`found` vs `not_found`). An empty `data.posts` array can still accompany `lookupStatus: "found"` when the handle resolves but no posts are returned. Call `GET /v1/threads/profiles/{handle}` first if you need `private` vs `not_found` for the account itself.