# Truth Social Posts by user API (truth_social.user_posts)

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

Truth Social Posts by user returns one Truth Social account's public posts, given its handle in `username`, and flags which of them are ReTruths or replies. Each row carries the post text, link, like, reply and repost counts, the language, hashtags and attached media, the publish time, and the author's handle, name, ID, follower count and verification. Journalists, policy researchers and media monitors use it to follow what a public figure or organization says on Truth Social: building a timeline of statements, measuring which posts draw engagement, or archiving posts for later research.

`is_repost` marks ReTruths, the platform's reposts, which carry another account's words, so leave them out when you quote the account. `repost_count` counts plain reposts and does not include quote posts. `language` is the platform's judgment and can be wrong.

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | The known Truth Social author whose posts should be read; this is not a topic keyword. |
| limit | integer (1–100) | no | 20 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| language | Content language code (for example zh, en) as judged by the platform; it can be wrong. |
| reply_count | Replies, usually replies to a comment. null means not disclosed. |
| repost_count | Reposts (as distinct from quote posts). null means not disclosed. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_name | Author's display name. |
| author_id | Author's unique ID on the platform. |
| author_follower_count | Author's follower count. null means not disclosed. |
| author_verified | platform-native meaning |
| reply_to_id | platform-native meaning |
| reply_to_account_id | platform-native meaning |
| is_reply | platform-native meaning |
| is_repost | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| media | platform-native meaning |
| hashtags | Hashtags in the text, in order of appearance; absent when there are none. |
| 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": "user_posts",
  "params": {
    "username": "realDonaldTrump"
  }
}'
```

```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": "user_posts",
        "params": {
            "username": "realDonaldTrump",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "truth_social",
  "action": "user_posts",
  "results": [
    {
      "id": "•••",
      "url": "https://truthsocial.com/@realDonaldTrump/117336883864922392",
      "text": "Keep the lights on, sideline Big Brother: Trump EPA rollback could save ratepayers $310 billion: https://justthenews.com/government/federal-agencies/trumps-epa-gets-action-roots-out-30-billion-waste-fraud-and-abuse",
      "language": "en",
      "reply_count": 20,
      "repost_count": 61,
      "like_count": 187,
      "author_username": "realDonaldTrump",
      "author_name": "•••",
      "author_id": "•••",
      "author_follower_count": 13079019,
      "author_verified": true,
      "is_reply": false,
      "posted_at": "2026-09-26T10:32:40.145000+00:00",
      "platform": "truth_social"
    },
    {
      "id": "•••",
      "url": "https://truthsocial.com/@realDonaldTrump/117336881513699850",
      "text": "Feds arrest, indict hundreds in Trump voter fraud crackdown: 'Catching it all over the country': https://justthenews.com/politics-policy/elections/feds-have-arrested-indicted-hundreds-voter-fraud-crackdown-catching-it",
      "language": "en",
      "reply_count": 24,
      "repost_count": 70,
      "like_count": 214,
      "author_username": "realDonaldTrump",
      "author_name": "•••",
      "author_id": "•••",
      "author_follower_count": 13079019,
      "author_verified": true,
      "is_reply": false,
      "posted_at": "2026-09-26T10:32:04.269000+00:00",
      "platform": "truth_social"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### How do I keep only posts the account wrote?

Drop rows where `is_repost` is true, which are ReTruths of other accounts' posts. Rows where `is_reply` is true are the account answering someone: `reply_to_id` gives the post it answered and `reply_to_account_id` the account. Keep or drop them depending on whether replies count as statements in your study.

### How is this different from Truth Social Replies?

Both take the same handle. Posts by user returns the account's posts, while the Truth Social Replies capability is built around the replies the account itself sent to other posts. Comments that other users leave under a post are outside both.

### How do I line posts up with events?

`posted_at` is an ISO 8601 timestamp in UTC, such as 2026-08-07T12:34:56+00:00. Convert it to the time zone of the events you compare against: in UTC, a post sent on a US evening often falls on the following calendar day.

## 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
