# Truth Social API

> Profiles and posts from public Truth Social accounts.

- **Platform:** [Truth Social](https://lurkapi.com/docs/truthsocial.md) (truthsocial.com)
- **Web page:** https://lurkapi.com/docs/truthsocial

## Overview

Read public Truth Social accounts the way logged-out visitors see them: profile stats, the latest posts with media and engagement counts, and single posts. Field names follow Mastodon's API (Truth Social runs on it), so Mastodon client code keeps working; every post also carries plain `text` next to the HTML `content`. Accounts explicitly hidden from logged-out visitors return 403 `not_public`. When the upstream cannot distinguish a hidden account from a missing one, the response is 404 `not_found`. Prominent accounts and most other public ones are visible.

Source: truthsocial.com.

## Try it live

Pick an endpoint and run it: real data, no signup, 5 free requests a day.

Live playground: https://lurkapi.com/docs/truthsocial#try

## Endpoints

- [Profile](https://lurkapi.com/docs/truthsocial/profile.md): An account's bio, avatar, follower and post counts, and verification. (GET /v1/truthsocial/profile · 1 credit)
- [User posts](https://lurkapi.com/docs/truthsocial/user-posts.md): An account's latest posts and ReTruths, newest first, 20 per page. (GET /v1/truthsocial/user/posts · 1 credit)
- [Post](https://lurkapi.com/docs/truthsocial/post.md): One post with its text, media, link preview and engagement counts. (GET /v1/truthsocial/post · 1 credit)

## Call it

Every endpoint is a `GET` with your key in the `x-api-key` header. For example, [Profile](https://lurkapi.com/docs/truthsocial/profile.md):

curl:

```bash
curl "https://api.lurkapi.com/v1/truthsocial/profile?handle=realDonaldTrump" \
  -H "x-api-key: YOUR_API_KEY"
```

[Get a free API key](https://lurkapi.com/login?next=/dashboard)

## Use it in Claude

Once LurkAPI is [connected to Claude](https://lurkapi.com/docs.md#claude), each endpoint is a tool Claude can call:

| Tool | What it does |
| --- | --- |
| `truthsocial_profile` | [Profile](https://lurkapi.com/docs/truthsocial/profile.md): An account's bio, avatar, follower and post counts, and verification. |
| `truthsocial_user_posts` | [User posts](https://lurkapi.com/docs/truthsocial/user-posts.md): An account's latest posts and ReTruths, newest first, 20 per page. |
| `truthsocial_post` | [Post](https://lurkapi.com/docs/truthsocial/post.md): One post with its text, media, link preview and engagement counts. |