Headers
Get your API keyAPI key (`sfk_...`)
Link to the Truth Social post.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the post was found.
one of: found, not_found
Post when lookupStatus is `found`; null when `not_found`.
Truth Social status id.
pattern: ^\d{1,30}$
Canonical public Truth Social post URL.
min 1 chars
ISO-8601 creation timestamp.
ISO-8601 edit timestamp when available.
Plain-text post body.
Content warning / spoiler text when present.
Language code when available.
Visibility string when available.
Whether the post is marked sensitive.
Author snapshot when available.
Social platform for this author.
one of: truthsocial
Stable Truth Social account id as a string.
pattern: ^\d{1,30}$
Truth Social handle without a leading @.
min 1 chars
Public display name when available.
Avatar image URL when available.
Whether the account is marked verified.
Canonical public Truth Social profile URL.
min 1 chars
Parent status id when this is a reply.
pattern: ^\d{1,30}$
Parent account id when this is a reply.
pattern: ^\d{1,30}$
Quoted status id when present.
pattern: ^\d{1,30}$
Original status id when this is a repost.
pattern: ^\d{1,30}$
Engagement metrics.
Reply count when available.
≥ 0
Repost/reblog count when available.
≥ 0
Favorite count when available.
≥ 0
Upvote count when available.
≥ 0
Downvote count when available.
≥ 0
Media attachments in upstream order.
Normalized media type.
one of: image, video, audio, gifv, unknown
Primary media URL when available.
Preview/thumbnail URL when available.
Alt text / description when available.
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Duration in seconds for video/audio when available.
≥ 0
Link preview card when present.
Linked page URL.
min 1 chars
Link card title when available.
Link card description when available.
Link provider name when available.
Link card image URL when available.
Poll when present.
ISO-8601 poll expiration when available.
Whether the poll has expired.
Whether multiple choices are allowed.
Total votes when available.
≥ 0
Poll options in display order.
Poll option title.
Votes for this option when available.
≥ 0
Quoted post summary when present.
Quoted post id.
pattern: ^\d{1,30}$
Canonical quoted post URL.
min 1 chars
Plain-text body of the quote.
Quoted author handle without @ when available.
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/truthsocial/posts?url=https://truthsocial.com/@justthenews/116972401572691045" \
-H "x-api-key: YOUR_API_KEY"Responses
Truth Social post lookup result.