List Truth Social profile posts
List posts from a Truth Social profile by handle or account id.
Headers
Get your API keyAPI key (`sfk_...`)
Truth Social handle or account id.
min 1 chars · max 64 chars
Opaque pagination cursor from a previous response. Omit for the first page.
min 1 chars
When true, includes reply posts in the timeline. Adds 2 credits (4 total including the base lookup). Default: false (top-level posts only).
Maximum posts to return (1–20). Default: 20.
≥ 1 · ≤ 20
Endpoint-specific response payload.
Whether the profile was found.
one of: found, not_found
Profile when found; null when not found.
Social platform for this profile.
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.
Plain-text profile biography.
Canonical public Truth Social profile URL.
min 1 chars
Avatar image URL when publicly available.
Header/banner image URL when publicly available.
Website URL from the profile when publicly safe.
Free-text location when present.
ISO-8601 timestamp when the account was created.
ISO-8601 date of the latest public post when available.
Whether the account is marked verified.
Whether the account requires follow approval.
Whether the account is marked as a bot.
Follower, following, and post counts.
Follower count when available.
≥ 0
Following count when available.
≥ 0
Public post count when available.
≥ 0
Posts in reverse chronological order when found. Replies excluded unless `includeReplies=true`. Empty when not found or the account has no public posts.
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.
Opaque cursor for older posts, or null when none remain.
Whether another page of older posts is 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/profiles/realDonaldTrump/posts" \
-H "x-api-key: YOUR_API_KEY"Responses
Truth Social profile posts listing.