# Truth Social API — UnifAPI

> Profiles, posts, engagement. Read public Truth Social profiles with follower counts, a profile's posts with replies, reposts and likes, and single posts by URL.

- Category: Social platforms
- API base URL: https://api.unifapi.com
- Auth: `Authorization: Bearer <UnifAPI API key>` (OAuth recommended for MCP clients)
- MCP server: https://mcp.unifapi.com
- Developer docs: https://docs.unifapi.com/api/truth-social
- OpenAPI spec: https://unifapi.com/openapi.json
- HTML page: https://unifapi.com/apis/truth-social
- Full catalog: https://unifapi.com/apis.md

## Agent workflows

- Follow public statements from political and media accounts on Truth Social for news and policy research.
- Compare engagement on posts by reply, repost and favorite counts over time.
- Cite a Truth Social post by URL with its text, media, link preview and timestamps in a research brief.

## Endpoints (3)

Every endpoint returns the UnifAPI JSON envelope (`request_id`, `data`, `pagination` on lists, `billing`) and bills max(records × credits per record, minimum) in credits.

### Get a Truth Social post by URL

`GET /truth-social/posts`

Returns one Truth Social post by its public URL, with author, text, media and engagement counts. Returns `not_found` when the post does not exist.

- Price: 1 credit per record, minimum 6 credits ($0.006) per call
- Required: `url` (query)
- Details: https://unifapi.com/apis/truth-social/posts/get
- Docs: https://docs.unifapi.com/api/truth-social/posts/get

### Get a Truth Social profile

`GET /truth-social/users/{username}`

Returns a public Truth Social profile by username: display name, bio, avatar, follower and post counts. Returns `not_found` when the profile does not exist.

- Price: 1 credit per record, minimum 6 credits ($0.006) per call
- Required: `username` (path)
- Details: https://unifapi.com/apis/truth-social/users/username/get
- Docs: https://docs.unifapi.com/api/truth-social/users/username/get

### List posts from a Truth Social profile

`GET /truth-social/users/{username}/posts`

Returns recent posts (truths) from a public Truth Social profile, newest first, with engagement counts and media. Paginate with `cursor`.

- Price: 1 credit per record, minimum 6 credits ($0.006) per call
- Required: `username` (path)
- Details: https://unifapi.com/apis/truth-social/users/username/posts/get
- Docs: https://docs.unifapi.com/api/truth-social/users/username/posts/get

## Related APIs

- [Twitch API](https://unifapi.com/apis/twitch/index.md) — Channels, videos, clips, schedules
- [Telegram API](https://unifapi.com/apis/telegram/index.md) — Public channels, posts, reactions
- [Rumble API](https://unifapi.com/apis/rumble/index.md) — Videos, channels, search, comments, transcripts
- [Snapchat API](https://unifapi.com/apis/snapchat/index.md) — Public profiles, Spotlight videos, comments
- [Linktree API](https://unifapi.com/apis/linktree/index.md) — Link-in-bio pages
- [Pinterest API](https://unifapi.com/apis/pinterest/index.md) — Pins, boards, search
