# User posts
> An account's latest posts and ReTruths, newest first, 20 per page.
- **Request:** `GET https://api.lurkapi.com/v1/truthsocial/user/posts`
- **Auth:** `x-api-key` header ([get a free key](https://lurkapi.com/login?next=/dashboard))
- **Cost:** 1 credit per call. Validation errors, `401`/`402`/`429` rejections and `5xx` failures are free; `not_found` is charged ([how charging works](https://lurkapi.com/docs.md#credits)).
- **MCP tool:** `truthsocial_user_posts` on `https://api.lurkapi.com/mcp`
- **Freshness:** responses are cached for up to 2 minutes
- **Try it live:** https://lurkapi.com/docs/truthsocial/user-posts#try (no signup)
- **Platform:** [Truth Social](https://lurkapi.com/docs/truthsocial.md) (truthsocial.com)
- **Web page:** https://lurkapi.com/docs/truthsocial/user-posts
## When to use this
Use it to monitor an account: every post with text, media, link previews and reply, ReTruth and like counts. Replies are left out; ReTruths are included, with the original post in `reblog`.
Pass `handle` or `user_id` (from profile). `user_id` skips a lookup, but both cost 1 credit.
**Pagination.** Pass the response's `next_max_id` back as `next_max_id` (with the same account) for older posts. It's null once a page comes back empty.
Unknown accounts return 404 `not_found`. 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.
## Parameters
All parameters go in the query string.
| Name | Type | Required | Default | Allowed values | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| `handle` | string | no | | | Username (e.g. `realDonaldTrump`), `@username` or profile URL. Required unless you pass `user_id`. | `realDonaldTrump` |
| `user_id` | string | no | | | Numeric account id from profile, e.g. `107780257626128497`. Used instead of `handle` when both are given. | |
| `next_max_id` | string | no | | | The `next_max_id` from the previous response, to get older posts. | |
| `trim` | boolean | no | `false` | `true`, `false` | `true` omits each post's HTML `content` (plain `text` stays) for a smaller response. | |
## Example request
Replace `YOUR_API_KEY` with your key, or set `LURKAPI_KEY` for the code. [Get a free key](https://lurkapi.com/login?next=/dashboard).
curl:
```bash
curl "https://api.lurkapi.com/v1/truthsocial/user/posts?handle=realDonaldTrump" \
-H "x-api-key: YOUR_API_KEY"
```
JavaScript:
```js
const params = new URLSearchParams({
handle: "realDonaldTrump",
});
const res = await fetch(`https://api.lurkapi.com/v1/truthsocial/user/posts?${params}`, {
headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.posts);
```
Python:
```python
import os
import requests
res = requests.get(
"https://api.lurkapi.com/v1/truthsocial/user/posts",
params={
"handle": "realDonaldTrump",
},
headers={"x-api-key": os.environ["LURKAPI_KEY"]},
timeout=60,
)
data = res.json()
if not data["success"]:
raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["posts"])
```
## Example response
A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in `…`.
200 OK (application/json):
```json
{
"success": true,
"credits_remaining": 999988,
"credits_charged": 1,
"posts": [
{
"id": "117357090030899348",
"created_at": "2026-09-30T00:11:21.773Z",
"url": "https://truthsocial.com/@realDonaldTrump/117357090030899348",
"content": "",
"text": "",
"title": null,
"language": null,
"visibility": "public",
"sensitive": false,
"spoiler_text": "",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"quote_id": null,
"replies_count": 1313,
"reblogs_count": 2788,
"favourites_count": 9614,
"upvotes_count": 9614,
"downvotes_count": 0,
"edited_at": null,
"media_attachments": [
{
"id": "117357089273579505",
"type": "image",
"url": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/media_attac…",
"preview_url": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/media_attac…",
"description": null,
"meta": {
"original": {
"width": 794,
"height": 1294,
"aspect": 0.6136012364760433,
"duration": null
},
"small": {
"width": 626,
"height": 1021,
"aspect": 0.6131243878550441,
"duration": null
}
}
}
],
"card": null,
"group": null,
"mentions": [],
"tags": [],
"account": {
"id": "107780257626128497",
"username": "realDonaldTrump",
"acct": "realDonaldTrump",
"display_name": "Donald J. Trump",
"url": "https://truthsocial.com/@realDonaldTrump",
"avatar": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/av…",
"verified": true,
"followers_count": 13086928
},
"reblog": null,
"quote": null
},
{
"id": "117356339820644146",
"created_at": "2026-09-29T21:00:34.470Z",
"url": "https://truthsocial.com/@realDonaldTrump/117356339820644146",
"content": "Iran Has Lost Control of the Strait: