Truth Social API

Retrieve Truth Social user posts, replies, single content items and trending samples to monitor discussions.

Provide complete post URLs containing author paths for reliable retrieval; single IDs alone cannot reliably infer authors.

Platform availability

24h health
Normal
Normal

Last 30 days

Available capabilities

Each Truth Social action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.

CapabilityWhat it doesPer 1,00024-hour health
ProfilesprofileCheck a Truth Social account's display name, bio, location, follower, following and post counts, verification and creation date by handle.$1.39 per 1,000 requestsNormal
Posts by useruser_postsCollect a sample of posts from a Truth Social account, with text, language, reply, repost and like counts, hashtags and media.$1.39 per 1,000 requestsNormal
RepliesrepliesList the replies a Truth Social account has written to other posts, with the post and account each one answers.$1.39 per 1,000 requestsNormal
Post detailspostFetch one Truth Social post's text, author, publish time, engagement counts, hashtags and media from its full URL.$1.39 per 1,000 requestsNormal
TrendingtrendingSee which posts Truth Social lists as trending, with author, publish time and reply, repost and like counts.$1.39 per 1,000 requestsNormal

Open a capability for its parameters, response fields, code samples and trial.

What does each Truth Social action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

ActionRequiredOptionalDeliveryLimitPer 1,000Response fields
profile

Profiles

Check a Truth Social account's display name, bio, location, follower, following and post counts, verification and creation date by handle. is_private and is_verified reflect visible signals only; they neither widen access nor stand in for an identity check.

username—Sync delivery—$1.39 per 1,000 requestsuser_id · username · display_name · bio · url · external_url · location · follower_count · following_count · post_count · is_verified · is_private · avatar_url · header_url · created_at · platform
user_posts

Posts by user

Collect a sample of posts from a Truth Social account, with text, language, reply, repost and like counts, hashtags and media. Check is_reply and is_repost before treating a row as the account's own words.

username—Sync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsid · url · text · language · reply_count · repost_count · like_count · author_username · author_name · author_id · author_follower_count · author_verified · reply_to_id · reply_to_account_id · is_reply · is_repost · posted_at · media · hashtags · platform
replies

Replies

List the replies a Truth Social account has written to other posts, with the post and account each one answers. These are the account's own replies, not the comment thread under its posts, and the parent post is not included.

username—Sync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsid · url · text · language · reply_count · repost_count · like_count · author_username · author_name · author_id · author_follower_count · author_verified · reply_to_id · reply_to_account_id · is_reply · is_repost · posted_at · media · hashtags · platform
post

Post details

Fetch one Truth Social post's text, author, publish time, engagement counts, hashtags and media from its full URL. Use a URL that includes the @author path; id and post_url are compatibility inputs that do not replace url.

urlid, post_urlSync delivery—$1.39 per 1,000 requestsid · url · text · language · reply_count · repost_count · like_count · author_username · author_name · author_id · author_follower_count · author_verified · reply_to_id · reply_to_account_id · is_reply · is_repost · posted_at · media · hashtags · platform
trending

Trending

See which posts Truth Social lists as trending, with author, publish time and reply, repost and like counts. No inputs are needed; the order is not an explanation of the algorithm, a complete ranking or a real-time trend.

—Sync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsid · url · text · language · reply_count · repost_count · like_count · author_username · author_name · author_id · author_follower_count · author_verified · reply_to_id · reply_to_account_id · is_reply · is_repost · posted_at · media · hashtags · platform

What do the Truth Social profile parameters mean?

Check a Truth Social account's display name, bio, location, follower, following and post counts, verification and creation date by handle. is_private and is_verified reflect visible signals only; they neither widen access nor stand in for an identity check.

Full API reference: parameters, code samples, response example and health →
usernameRequired
A Truth Social account handle, with or without @; this is not a display name or profile URL.
Truth Social: Account Handles, Display Names, and Profile Website Fields — Official terminology distinguishes handle/username, display name, and profile Website links. This reference explains identity fields only; the presence of usernames, verification badges, or web pages does not verify real-world entity identity or private access permissions. · Checked

What do the Truth Social user_posts parameters mean?

Collect a sample of posts from a Truth Social account, with text, language, reply, repost and like counts, hashtags and media. Check is_reply and is_repost before treating a row as the account's own words.

Full API reference: parameters, code samples, response example and health →
usernameRequired
The known Truth Social author whose posts should be read; this is not a topic keyword.
Truth Social: Truth and ReTruth Represent Distinct Actions — Official documentation defines Truth as published content, ReTruth as reposting, and QuoteTruth as quote-reposting with added commentary. This gateway does not guarantee a distinct QuoteTruth structural field and does not treat all returned items as original content. · Checked

What do the Truth Social replies parameters mean?

List the replies a Truth Social account has written to other posts, with the post and account each one answers. These are the account's own replies, not the comment thread under its posts, and the parent post is not included.

Full API reference: parameters, code samples, response example and health →
usernameRequired
The author whose own replies should be listed. It does not identify a post's full comment thread.
Truth Details Comment UI vs. Author Reply Lists — Official Truth Social documentation shows that post comments are viewed under Truth Details. However, the `replies` action accepts an author `username` as its request target. Reading comments for a single post is functionally distinct from querying an author's reply history and must not be treated as equivalent. · Checked

What do the Truth Social post parameters mean?

Fetch one Truth Social post's text, author, publish time, engagement counts, hashtags and media from its full URL. Use a URL that includes the @author path; id and post_url are compatibility inputs that do not replace url.

Full API reference: parameters, code samples, response example and health →
urlRequired
Full post URL, recommended to include the @author path to locate both the author and the post simultaneously. Do not pass short links that omit the author identifier.
Truth Social: Single Truths, Media Attachments, and Comment Access — Official Truth Social documentation distinguishes published Truth content from the comment interface beneath single-post details. Referencing this object structure only clarifies resource boundaries; it does not grant comment exporting, posting, deleting, or arbitrary attachment support. · Checked
idOptional
Compatibility input for the post ID. When used alone, it cannot reliably infer the author. Prefer using the full url without relying on a default author fallback.
post_urlOptional
Compatibility input for the post URL. It has lower precedence than url and does not remove the public required field status.

What do the Truth Social trending parameters mean?

See which posts Truth Social lists as trending, with author, publish time and reply, repost and like counts. No inputs are needed; the order is not an explanation of the algorithm, a complete ranking or a real-time trend.

Full API reference: parameters, code samples, response example and health →

This action has no business parameters. Send only the platform and action identifiers.

How to use the Truth Social API

  1. 01Read the public catalog and choose a platform action.
  2. 02Send the platform, action, and required parameters to POST /api/v1/social.
  3. 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
  4. 04Store the structured response fields needed by your application.
truth_social_profile.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"truth_social","action":"profile","params":{"username":"<username>"}}'

Truth Social API questions

What can I retrieve with the Truth Social API?

Set platform to truth_social. The current catalog lists profiles, posts by user, replies, post details, and trending. These action names identify different Truth Social objects or views; they are not interchangeable search modes.

Which input starts a Truth Social `profile` request?

A Truth Social account handle, with or without @; this is not a display name or profile URL. Send it as username inside params.

Which fields can Truth Social `profile` return?

Its declared schema includes user_id, username, display_name, and bio. A declared field can still be absent from an individual record, and every other action has its own field list.

Does every Truth Social action return immediately?

Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.