Social Fetch
Threads

Get Threads profile

Get a Threads profile for a creator or account.

GET/v1/threads/profiles/{handle}
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
handle*stringpath

Threads handle to look up, with or without a leading @.

min 1 chars · max 64 chars

Response fields
27

Endpoint-specific response payload.

datalookupStatus
string

Whether the profile was resolved.

one of: found, private, not_found

Profile details when available.

dataprofileplatform
string

Social platform for this profile.

one of: threads

dataprofilehandle
string

Threads username without the leading @.

dataprofiledisplayName
stringnullable

Public display name shown on the Threads profile.

dataprofilebio
stringnullable

Profile biography text.

dataprofileavatarUrl
stringnullable

Best available avatar image URL for the profile.

dataprofileverified
boolean

Whether the profile is marked as verified.

dataprofileprofileUrl
string

Canonical public Threads profile URL.

min 1 chars

dataprofileprivateAccount
booleanoptional

Whether the Threads account is private.

dataprofileplatformUserId
stringoptional

Threads profile id as a string when available.

dataprofilethreadsOnlyUser
booleanoptional

Whether the account is marked as a Threads-only profile.

Structured bio links when available.

dataprofilebioLinks[]url
string

Destination URL for the profile link.

min 1 chars

dataprofilebioLinks[]verified
booleanoptional

Whether the profile link is marked as verified.

dataprofilebioLinks[]id
stringoptional

Stable link identifier when available.

Avatar image versions when available.

dataprofileavatarVersions[]url
string

Avatar image URL.

min 1 chars

dataprofileavatarVersions[]width
integernullableoptional

Avatar image width in pixels when available.

≥ 0

dataprofileavatarVersions[]height
integernullableoptional

Avatar image height in pixels when available.

≥ 0

Profile metrics when available.

datametricsfollowers
integernullable

Follower count for the profile when available.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/threads/profiles/charlidamelio" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Lookup result. Check `data.lookupStatus` for `found`, `private`, or `not_found`.

On this page

No Headings