Truth Social User Posts API

Endpoint

GET /v1/truthsocial/user/posts

Parameters

username *

Truth Social username, with or without leading @ (max 100 characters)

pages

Number of pages to fetch, 1-10 (default: 1). Each page returns up to 20 posts.

get_sentiment

Set to true to add AI emotion analysis (+$0.001/page)

Response fields

posts

Array of the user's recent posts

title

Post title (format: @username on Truth Social)

url

Direct link to the post

date

Publication date and time

author

Truth Social username

source

Platform name (Truth Social)

domain

truthsocial.com

snippet

Post text with formatting removed

likes

Number of likes

replies

Number of replies

reposts

Number of reposts

post_id

Truth Social post ID

content_html

Original post body as HTML, with links and mentions preserved

media

Media attachments, each with media_id, type (e.g. image, video), url, and description

hashtags

Hashtags used in the post

language

Detected language code, empty when not detected

visibility

Post visibility (e.g. public)

sensitive

Whether the post is marked sensitive

spoiler_text

Content warning text, empty when none

Example Request

curl "https://apidirect.io/v1/truthsocial/user/posts?username=realDonaldTrump&pages=2" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/truthsocial/user/posts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "username": "realDonaldTrump",
        "pages": 2
    }
)
print(response.json())

Example Response

{
  "posts": [
    {
      "title": "@realDonaldTrump on Truth Social",
      "url": "https://truthsocial.com/@realDonaldTrump/117043133534824966",
      "date": "2026-08-05 13:28:05",
      "author": "realDonaldTrump",
      "source": "Truth Social",
      "domain": "truthsocial.com",
      "snippet": "Thank you for your attention to this matter! President DJT",
      "likes": 5514,
      "replies": 567,
      "reposts": 1399,
      "post_id": "117043133534824966",
      "content_html": "<p>Thank you for your attention to this matter! President DJT</p>",
      "media": [
        {
          "media_id": "117041192378469520",
          "type": "video",
          "url": "https://static-assets-1.truthsocial.com/media_attachments/files/117/041/192/original/9cbc020383d40cd5.mp4",
          "description": ""
        }
      ],
      "hashtags": [],
      "language": "en",
      "visibility": "public",
      "sensitive": false,
      "spoiler_text": "",
      "sponsored": false,
      "is_reply": false,
      "in_reply_to_id": ""
    }
  ],
  "username": "realDonaldTrump",
  "pages": 2,
  "count": 40
}

Frequently asked questions

How do I specify the user?

Provide the username with or without a leading @ (e.g. realDonaldTrump or @realDonaldTrump).

How many posts are returned per page?

Each page returns up to 20 of the user's most recent posts, newest first. Use the pages parameter (1-10) to fetch more in a single call; you are billed per page requested.

Does the feed include replies?

Yes. A user's feed can include their original posts and their replies. Use the is_reply field to distinguish them.

How do I get the post text without HTML?

Use snippet for clean plain text. content_html keeps the original markup if you need the links and mentions.

What happens if the username doesn't exist?

The endpoint returns 404 with code: "not_found". You are not charged for not_found responses.

How does pricing work?

You only pay for successful requests. The Truth Social User Posts API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 5 simultaneous requests per endpoint per user. If you need more, just get in touch.