Truth Social

Get Truth Social profile

Get a Truth Social profile by handle or account id.

GET/v1/truthsocial/profiles/{handle}
2credits
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
handle*stringpath

Truth Social handle or account id.

min 1 chars · max 64 chars

Response fields
27

Endpoint-specific response payload.

datalookupStatus
string

Whether the profile was found.

one of: found, not_found

Profile when lookupStatus is `found`; null when `not_found`.

dataprofileplatform
string

Social platform for this profile.

one of: truthsocial

dataprofileid
string

Stable Truth Social account id as a string.

pattern: ^\d{1,30}$

dataprofilehandle
string

Truth Social handle without a leading @.

min 1 chars

dataprofiledisplayName
stringnullable

Public display name when available.

dataprofilebio
stringnullable

Plain-text profile biography.

dataprofileprofileUrl
string

Canonical public Truth Social profile URL.

min 1 chars

dataprofileavatarUrl
stringnullable

Avatar image URL when publicly available.

dataprofileheaderUrl
stringnullable

Header/banner image URL when publicly available.

dataprofilewebsiteUrl
stringnullable

Website URL from the profile when publicly safe.

dataprofilelocation
stringnullable

Free-text location when present.

dataprofilecreatedAt
stringnullable

ISO-8601 timestamp when the account was created.

dataprofilelastStatusAt
stringnullable

ISO-8601 date of the latest public post when available.

dataprofileisVerified
boolean

Whether the account is marked verified.

dataprofileisLocked
boolean

Whether the account requires follow approval.

dataprofileisBot
boolean

Whether the account is marked as a bot.

Follower, following, and post counts.

dataprofilemetricsfollowers
integernullable

Follower count when available.

≥ 0

dataprofilemetricsfollowing
integernullable

Following count when available.

≥ 0

dataprofilemetricsposts
integernullable

Public post count 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

metacached
booleanoptional

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/truthsocial/profiles/realDonaldTrump" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Truth Social profile lookup result.