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.
Pagination state for the current page of posts.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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.