> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.yoinkit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# User Posts

> As of 8/27/2025, Truth Social is only letting you view the public profile/posts of prominent users (like Trump and Vance), but requiring auth for everyone else. So sadly most other accounts will not work :(

## Parameters

<ParamField query="handle" type="string">
  Truth Social username (e.g., `realDonaldTrump`)
</ParamField>

<ParamField query="user_id" type="string">
  Truth Social user id. Use this for faster response times. Trumps is 107780257626128497. It is the 'id' field in the profile endpoint. (e.g., `107780257626128497`)
</ParamField>

<ParamField query="next_max_id" type="string">
  Used to paginate to next page (e.g., `107780257626128497`)
</ParamField>

<ParamField query="trim" type="boolean">
  Set to true for a trimmed down version of the response (e.g., `false`)
</ParamField>

## Example Request

```bash theme={null}
curl -X GET "https://yoinkit.ai/api/v1/openclaw/truthsocial/user/posts" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

## Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "posts": [
      {
        "text": "...",
        "id": "114315232218538121",
        "created_at": "2025-04-10T19:06:55.053Z",
        "visibility": "public",
        "url": "https://truthsocial.com/@realDonaldTrump/114315232218538121",
        "replies_count": 123,
        "reblogs_count": 456,
        "favourites_count": 7890,
        "account": { "username": "realDonaldTrump" }
      }
      // ... more posts
    ]
  },
  "meta": {
    "platform": "truthsocial",
    "endpoint": "user-posts",
    "request_id": "req_abc123"
  }
}
```

> Response data is returned directly from the Yoinkit API.