# Truth Social Details API (truth_social.profile)

- Canonical page: [https://everyinfra.com/en/truth-social-api/profile](https://everyinfra.com/en/truth-social-api/profile?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "truth_social", "action": "profile", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

Truth Social Details reads the public profile of one Truth Social account from its handle and returns a single record: `user_id`, handle, display name, bio, location, follower, following and post counts, verification and privacy flags, avatar and header images, and the account's creation date. Researchers, journalists and media monitors use it to identify an account, size its audience and see how long it has existed before they track or cite what it posts.

Send the handle with or without the @; `username` is required, so every request names its account explicitly. `location` is passed through exactly as the profile shows it, and `bio` may contain line breaks and emoji. Treat a null follower, following or post count as undisclosed, and a null `is_verified` as unknown rather than unverified.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=truth_social&action=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | A Truth Social account handle, with or without `@`; this is not a display name or profile URL. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | User's unique ID on the platform. |
| username | Username (@handle). |
| display_name | Display name; can differ from username. |
| bio | Profile bio written by the account; may contain line breaks and emoji. |
| url | Link to the record on the platform. |
| external_url | platform-native meaning |
| location | Location description passed through as is; the format varies by platform. |
| follower_count | Followers. null means not disclosed, not 0. |
| following_count | Accounts followed. null means not disclosed, not 0. |
| post_count | Total posts. null means not disclosed, not 0. |
| is_verified | Whether the platform verified the account. null means it cannot be determined. |
| is_private | platform-native meaning |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| header_url | platform-native meaning |
| created_at | Creation time, same format as posted_at. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "truth_social",
  "action": "profile",
  "params": {
    "username": "<TRUTH_SOCIAL_USERNAME>"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "truth_social",
        "action": "profile",
        "params": {
            "username": "<TRUTH_SOCIAL_USERNAME>",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "truth_social",
  "action": "profile",
  "results": {
    "user_id": …,
    "username": …,
    "display_name": …,
    "bio": …,
    "url": …,
    "external_url": …,
    "location": …,
    "follower_count": …,
    "following_count": …,
    "post_count": …,
    "is_verified": …,
    "is_private": …,
    "avatar_url": …,
    "header_url": …,
    "created_at": …,
    "platform": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### What do I pass as `username`?

The account's handle, the name after the @ on its profile and in its profile link; the leading @ is optional. Use the handle rather than the display name, which can differ from it; the result shows the display name separately in `display_name`, next to the `username` you asked for.

### How do I read the account's posts and replies?

Use the same handle with the Truth Social Posts by user capability for the account's posts, and with Truth Social Replies for the replies the account itself has written to other posts. Both take `username` in the same form as this capability.

### What does `is_private` mean for my analysis?

When it is true, the account keeps its posts from the public, so the profile may be all you can read about it. Check it before you schedule post collection, and keep private accounts on a separate list rather than recording them as accounts that never post.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=truth_social
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
