# API Direct – Truth Social User Posts Feed

> API Direct – Truth Social User Posts Feed is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Fetches a Truth Social user's recent posts by username, with optional AI sentiment analysis per post.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/truthsocial/user/posts?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-truth-social-user-posts-feed-384412ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oTjnaK5-78kjMgjHfgeHb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-direct-truth-social-user-posts-feed-384412ce
```

Example prompt: Pull the last 2 pages of posts from Truth Social user @kari_lake and include AI sentiment analysis so I can see the emotional tone of each post.

## When to prefer this

Use this endpoint when you need to retrieve posts from a specific Truth Social user by username, especially when optional AI-powered sentiment/emotion analysis per post is desired. Prefer it over manual scraping or general social media APIs that don't cover Truth Social. It supports pagination up to 20 pages so it works for both quick spot-checks and deeper historical pulls.

## Known failure modes

- Username not found — returns empty result or 404-style error if the account does not exist
- Private or suspended account — posts may not be accessible
- Exceeding page limit — maximum of 20 pages per call; requests above this are rejected
- Rate limiting or payment failure — x402 payment not processed correctly results in 402 response
- Username with special characters may need URL encoding

## How this service works

Get a single Truth Social user's recent posts (their feed) by username.

## Output

Returns a merged list of up to 20 posts per page (up to 400 posts total across 20 pages) from the specified Truth Social user. Each post includes standard post content fields. When sentiment analysis is enabled, each post also includes a `sentiment` object with per-emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0–100), a dominant_emotion label, emotional_intensity (0–10), and a polarity classification (positive, negative, or neutral).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "username"
     ],
     "properties": {
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 20,
       "minimum": 1,
       "description": "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."
      },
      "username": {
       "type": "string",
       "maxLength": 100,
       "description": "Truth Social username, with or without leading @ (max 100 characters)"
      },
      "get_sentiment": {
       "type": "boolean",
       "default": false,
       "description": "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 t"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-truth-social-user-posts-feed-384412ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)