# Truth Social Post API (https://www.socialcrawl.dev/platforms/truthsocial/post)

> Returns detailed information about a specific Truth Social post including the text content, like count, retruth count, reply count, media attachments, author info, and creation timestamp.

TL;DR: `GET /v1/truthsocial/post` 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 |
| --- | --- | --- |
| `url` | yes | Full URL of the Truth Social post |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/truthsocial/post?url=https%3A%2F%2Ftruthsocial.com%2F%40realDonaldTrump%2Fposts%2F123456789" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a Truth Social post's details with an API?

Send a GET request to /v1/truthsocial/post with the full truth URL in the url parameter. SocialCrawl returns the post text, like count, retruth count, reply count, media attachments, author information, and creation timestamp.

### What engagement fields does the endpoint return?

The response breaks engagement into likes, comments (replies), and shares (retruths). Every field lives under the unified post.engagement object so you can compare engagement between Truth Social and other platforms using the exact same code path.

### Does it work for retruthed and reshared truths?

Yes. Retruthed posts include the original author info so you can trace the truth back to its source without an extra lookup. Media attachments — images and videos — come back with URLs, thumbnails, and where available, duration.

### Where do I get the URL to pass in?

Use the truth URL from the Truth Social web UI — the format is https://truthsocial.com/@handle/posts/id. You can also chain the user/posts endpoint to list truths and feed each truth URL into the post endpoint for detailed engagement numbers.

### How fast is the Truth Social Post API?

Most requests return JSON in 1–3 seconds. The endpoint uses the post cache category so repeat requests for the same truth URL come back faster from the SocialCrawl cache, with no extra credit charge on cache hits within the cache window.

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 fetch a Truth Social post's details with an API
- What does the SocialCrawl Truth Social Post API return?