---
title: "Truth Social User Posts"
method: GET
path: "/v1/truthsocial/user/posts"
tags: ["Truth Social"]
---

# Truth Social User Posts

`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`

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.

## Query parameters

- `username` string, required
- `pages` integer
- `get_sentiment` boolean

## Response `200`

Successful response

- TruthsocialUserPostsResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `count` number, nullable
  - `pages` number, nullable
  - `username` string, nullable
  - `posts` object[], nullable
    - `title` string, nullable
    - `url` string, nullable
    - `date` string, nullable
    - `author` string, nullable
    - `source` string, nullable
    - `domain` string, nullable
    - `snippet` string, nullable
    - `likes` number, nullable
    - `replies` number, nullable
    - `reposts` number, nullable
    - `post_id` string, nullable
    - `content_html` string, nullable
    - `media` object[], nullable
      - `media_id` string, nullable
      - `type` string, nullable
      - `url` string, nullable
      - `description` string, nullable
    - `hashtags` unknown[], nullable
      - unknown
    - `language` string, nullable
    - `visibility` string, nullable
    - `sensitive` boolean, nullable
    - `spoiler_text` string, nullable
    - `sponsored` boolean, nullable
    - `is_reply` boolean, nullable
    - `in_reply_to_id` string, nullable

## Other responses

- `400`: Bad request: a required parameter is missing or a value is invalid (code: missing_parameter or invalid_parameter).
- `401`: Unauthorized: the API key is missing or invalid (code: missing_api_key or invalid_api_key).
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `404`: Not found: the user does not exist or could not be resolved (code: not_found).
- `429`: Rate limit exceeded, or too many concurrent requests for this endpoint
- `500`: Internal server error (code: server_error).
- `502`: Temporary failure retrieving Truth Social data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)