Truth Social Profile API
Resolve a public Truth Social username or account id to a profile card — display name, bio, avatar, verification, and metrics — without a Truth Social login.
GET /v1/truthsocial/profiles/{handle}2 credits per successful request.
About this endpoint
Political monitors, news desks, and enrichment jobs often need a Truth Social card before they ingest posts: does this handle resolve, what does the public page show for size, and is the account verified. Mastodon-shaped clients still leave you with a second auth story and fragile HTML scrapes when Truth Social is only one source beside TikTok or Telegram.
`GET /v1/truthsocial/profiles/{handle}` is the dedicated lookup. Pass the public username used on `truthsocial.com/@{handle}` (with or without a leading `@`) or a Truth Social account id, send `x-api-key`, and read `data.lookupStatus` before you write a row. On `found`, `data.profile` carries handle, display name, bio, profile URL, avatar and header, website, location, created and last-status timestamps, verification / locked / bot flags, and `metrics` (followers, following, posts when Truth Social shows them). `not_found` returns null profile data; HTTP 200 still means the request finished.
Credit pricing for this operation comes from the API registry and appears on this page, and `meta.creditsCharged` is the billing source of truth. For recent posts, use the separate profile-posts list route; this endpoint stops at the profile card.
Truth Social Profile API FAQ
How do I fetch a Truth Social profile by handle?
Call GET /v1/truthsocial/profiles/{handle} with your Social Fetch API key in the x-api-key header. The path accepts a public username (with or without @) or an account id. Full parameters and examples are in the API docs linked from this page.
How many credits does a Truth Social profile lookup cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
What does lookupStatus mean?
found means data.profile is populated. not_found means the handle or account id did not resolve to a public profile. Always branch on lookupStatus before treating the payload as a found card. HTTP 200 only means the request finished.
Can I pass the handle with or without @?
Yes. Pass the public username used on truthsocial.com/@{handle} — with or without a leading @ — or pass the account id instead. Social Fetch normalizes handles the same way on this route and on the profile-posts path.
What fields are in the Truth Social profile card?
On found, data.profile includes platform, id, handle, displayName, bio, profileUrl, avatarUrl, headerUrl, websiteUrl, location, createdAt, lastStatusAt, isVerified, isLocked, isBot, and metrics (followers, following, posts when present).
Do I need a Truth Social login?
No. Social Fetch authenticates with your Social Fetch API key only. These routes read publicly visible profiles; they do not post, DM, or manage accounts.
Is this the same as listing profile posts?
No. This endpoint returns the profile card only. To page recent posts for a handle or account id, use GET /v1/truthsocial/profiles/{handle}/posts (a separate marketplace operation). For one status by URL, use GET /v1/truthsocial/posts?url=.