# Truth Social User Posts API (https://www.socialcrawl.dev/platforms/truthsocial/user-posts)

> Returns a list of recent truths posted by a Truth Social user. Each truth includes the text content, like count, retruth count, reply count, media attachments, and creation timestamp.

TL;DR: `GET /v1/truthsocial/user/posts` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | no | Truth Social username without the @ symbol |
| `user_id` | no | Truth Social user id. Use this for faster response times. Trumps is 107780257626128497. It is the 'id' field in the profile endpoint. |
| `next_max_id` | no | Used to paginate to next page |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/truthsocial/user/posts" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list a Truth Social user's recent truths with the API?

Send a GET request to /v1/truthsocial/user/posts with either a handle (no @ symbol) or a user_id parameter. SocialCrawl returns an array of recent truths including the text, like count, retruth count, reply count, media attachments, and creation timestamp.

### Should I use handle or user_id for faster responses?

Prefer user_id when you already have it — it skips the extra lookup step and returns faster. The user_id comes back in the profile endpoint response. For example, Donald Trump's user_id is 107780257626128497, and passing it beats re-resolving the handle every call.

### How do I paginate through older truths?

The response includes a next_max_id cursor on the last page of results. Pass that value back in as next_max_id on your follow-up request to continue fetching older truths. Keep going until the cursor is empty to reach the full history available upstream.

### What fields does each truth include?

Every truth has its id, text content, like count, retruth count, reply count, media URLs, author info, and created_at timestamp. Field names stay consistent with other SocialCrawl platforms so you can reuse the same processing logic.

### Can I trim the response to save bandwidth?

Yes. Pass trim=true and the endpoint returns a compact payload with only the essential fields. Useful when you are ingesting Truth Social truths at scale into a pipeline and want to minimise bandwidth and parsing overhead on your side.

See the full Truth Social API: https://www.socialcrawl.dev/platforms/truthsocial

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to list Truth Social user posts with an API
- What data does the SocialCrawl Truth Social user/posts endpoint return?