Truth Social

Truth Social User Posts

Get a single Truth Social user's recent posts (their feed) by username. Returns post text, engagement metrics (replies, reposts, likes), media attachments (image, video and other Mastodon-style types), hashtags, language, visibility, reply status and a direct link to each post. Set get_sentiment=true to add AI emotion analysis (+$0.001/page).

Price: $0.006 per page. Free tier: 50 requests/month.

get/v1/truthsocial/user/posts

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/truthsocial/user/posts
  • Auth: API key in header X-API-Key

Query parameters

usernamestring required

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

pagesinteger

Number of pages to fetch and merge into one response (1-20, billed per page). Each page returns up to 20 posts. Fetching stops early when there are no more results.

get_sentimentboolean

Set to true to add AI emotion analysis to each post. Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any post that cannot be scored returns sentiment: null.

Response

Successful response

countnumber nullable
pagesnumber nullable
usernamestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.