Docs · User posts

User posts

An account's latest posts and ReTruths, newest first, 20 per page.

1 credit per callFresh within 2 minutesMCP tool: truthsocial_user_posts

GEThttps://api.lurkapi.com/v1/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.

Parameter	Description
`handle` stringoptional	Username (e.g. `realDonaldTrump`), `@username` or profile URL. Required unless you pass `user_id`. Example `realDonaldTrump`
`user_id` stringoptional	Numeric account id from profile, e.g. `107780257626128497`. Used instead of `handle` when both are given.
`next_max_id` stringoptional	The `next_max_id` from the previous response, to get older posts.
`trim` booleanoptional	`true` omits each post's HTML `content` (plain `text` stays) for a smaller response. One of `truefalse` Default `false`

Example request

Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.

curlJavaScriptPython

JavaScript · reads your key from LURKAPI_KEY

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 · reads your key from LURKAPI_KEY

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 ….

Show the example response (4 KB)

{
  "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": "<p></p>",
      "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": "<p>Iran Has Lost Control of the Strait: <a href=\"https://x.com/Burggrabe…",
      "text": "Iran Has Lost Control of the Strait: https://x.com/BurggrabenH/status/2104361288000221497",
      "title": null,
      "language": "en",
      "visibility": "public",
      "sensitive": false,
      "spoiler_text": "",
      "in_reply_to_id": null,
      "in_reply_to_account_id": null,
      "quote_id": null,
      "replies_count": 727,
      "reblogs_count": 2628,
      "favourites_count": 10171,
      "upvotes_count": 10171,
      "downvotes_count": 0,
      "edited_at": null,
      "media_attachments": [],
      "card": {
        "url": "https://x.com/BurggrabenH/status/2104361288000221497",
        "title": "Alexander Stahel 🌻 (@BurggrabenH) on X",
        "description": "Iran Has Lost Control of The Strait",
        "type": "link",
        "provider_name": "x.com",
        "image": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/cache/previ…"
      },
      "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
    }
  ],
  "next_max_id": "117356339820644146"
}

Response fields

Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.

Show all 205 fields

Field	Type	Description
success	true	Always true here; errors have `success: false`.
credits_remaining	number	Your balance after this call. On anonymous playground calls: free tries left today.
credits_charged	number	Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
posts	object[]	Posts and ReTruths, newest first.
posts[].id	string	Post id, e.g. `117351985093810875`.
posts[].created_at	string	Posted at, ISO 8601.
posts[].url	string	The post on truthsocial.com.
posts[].content	stringoptional	Post text as HTML. Omitted with trim=true.
posts[].text	string	Post text, plain. Empty for media-only posts and plain reposts.
posts[].title	stringnullable	Title, on group posts that have one; else null.
posts[].language	stringnullable	Language code (e.g. `en`) when detected; often null.
posts[].visibility	string	`public`, or `group` for posts in a group.
posts[].sensitive	boolean	Marked sensitive (media hidden behind a warning).
posts[].spoiler_text	string	Content warning; empty if none.
posts[].in_reply_to_id	stringnullable	The post this replies to; null if not a reply.
posts[].in_reply_to_account_id	stringnullable	Author of the post this replies to.
posts[].quote_id	stringnullable	The quoted post's id; null if not a quote.
posts[].replies_count	number	Replies.
posts[].reblogs_count	number	ReTruths (reposts).
posts[].favourites_count	number	Likes.
posts[].upvotes_count	numbernullable	Upvotes (Truth Social's likes); null if not reported.
posts[].downvotes_count	numbernullable	Downvotes; null if not reported.
posts[].edited_at	stringnullable	Last edit, ISO 8601; null if never edited.
posts[].media_attachments	object[]	Images and videos, in order.
posts[].media_attachments[].id	string	Attachment id.
posts[].media_attachments[].type	string	`image`, `video`, `gifv`, `audio` or `unknown`.
posts[].media_attachments[].url	stringnullable	The file (full-size image or MP4).
posts[].media_attachments[].preview_url	stringnullable	A smaller image, or the video's thumbnail.
posts[].media_attachments[].description	stringnullable	Alt text; null if none.
posts[].media_attachments[].meta	object	Sizes, as Mastodon reports them.
posts[].media_attachments[].meta.original	objectnullable	Size of the file at `url`.
posts[].media_attachments[].meta.original.width	numbernullable	Width in pixels.
posts[].media_attachments[].meta.original.height	numbernullable	Height in pixels.
posts[].media_attachments[].meta.original.aspect	numbernullable	Width / height; null when not reported (videos).
posts[].media_attachments[].meta.original.duration	numbernullable	Length in seconds, for video and audio; else null.
posts[].media_attachments[].meta.small	objectnullable	Size of the image at `preview_url`.
posts[].media_attachments[].meta.small.width	numbernullable	Width in pixels.
posts[].media_attachments[].meta.small.height	numbernullable	Height in pixels.
posts[].media_attachments[].meta.small.aspect	numbernullable	Width / height; null when not reported (videos).
posts[].media_attachments[].meta.small.duration	numbernullable	Length in seconds, for video and audio; else null.
posts[].card	objectnullable	Link preview for the first link in the post; null if none.
posts[].card.url	string	The linked page.
posts[].card.title	stringnullable	Page title.
posts[].card.description	stringnullable	Page description.
posts[].card.type	stringnullable	`link`, `video`, `photo` or `rich`.
posts[].card.provider_name	stringnullable	Site name, e.g. `x.com`.
posts[].card.image	stringnullable	Preview image URL (hosted by Truth Social).
posts[].group	objectnullable	The group it was posted in; null for ordinary posts.
posts[].group.id	string	Group id.
posts[].group.display_name	string	Group name.
posts[].group.slug	stringnullable	URL name, e.g. `republicans`.
posts[].group.url	stringnullable	Group on truthsocial.com.
posts[].group.members_count	numbernullable	Members.
posts[].mentions	object[]	Accounts mentioned.
posts[].mentions[].id	string	Account id.
posts[].mentions[].username	string	Username without @.
posts[].mentions[].acct	string	Same as username.
posts[].mentions[].url	string	Profile on truthsocial.com.
posts[].tags	object[]	Hashtags used.
posts[].tags[].name	string	Hashtag without #.
posts[].tags[].url	string	Hashtag page on truthsocial.com.
posts[].account	object	The author.
posts[].account.id	string	Account id.
posts[].account.username	string	Username without @.
posts[].account.acct	string	Same as username.
posts[].account.display_name	string	Display name.
posts[].account.url	string	Profile on truthsocial.com.
posts[].account.avatar	stringnullable	Profile picture URL; null if none.
posts[].account.verified	boolean	Has the verified badge.
posts[].account.followers_count	number	Followers.
posts[].reblog	objectnullable	On a ReTruth (repost): the original post. null otherwise.
posts[].reblog.id	string	Post id, e.g. `117351985093810875`.
posts[].reblog.created_at	string	Posted at, ISO 8601.
posts[].reblog.url	string	The post on truthsocial.com.
posts[].reblog.content	stringoptional	Post text as HTML. Omitted with trim=true.
posts[].reblog.text	string	Post text, plain. Empty for media-only posts and plain reposts.
posts[].reblog.title	stringnullable	Title, on group posts that have one; else null.
posts[].reblog.language	stringnullable	Language code (e.g. `en`) when detected; often null.
posts[].reblog.visibility	string	`public`, or `group` for posts in a group.
posts[].reblog.sensitive	boolean	Marked sensitive (media hidden behind a warning).
posts[].reblog.spoiler_text	string	Content warning; empty if none.
posts[].reblog.in_reply_to_id	stringnullable	The post this replies to; null if not a reply.
posts[].reblog.in_reply_to_account_id	stringnullable	Author of the post this replies to.
posts[].reblog.quote_id	stringnullable	The quoted post's id; null if not a quote.
posts[].reblog.replies_count	number	Replies.
posts[].reblog.reblogs_count	number	ReTruths (reposts).
posts[].reblog.favourites_count	number	Likes.
posts[].reblog.upvotes_count	numbernullable	Upvotes (Truth Social's likes); null if not reported.
posts[].reblog.downvotes_count	numbernullable	Downvotes; null if not reported.
posts[].reblog.edited_at	stringnullable	Last edit, ISO 8601; null if never edited.
posts[].reblog.media_attachments	object[]	Images and videos, in order.
posts[].reblog.media_attachments[].id	string	Attachment id.
posts[].reblog.media_attachments[].type	string	`image`, `video`, `gifv`, `audio` or `unknown`.
posts[].reblog.media_attachments[].url	stringnullable	The file (full-size image or MP4).
posts[].reblog.media_attachments[].preview_url	stringnullable	A smaller image, or the video's thumbnail.
posts[].reblog.media_attachments[].description	stringnullable	Alt text; null if none.
posts[].reblog.media_attachments[].meta	object	Sizes, as Mastodon reports them.
posts[].reblog.media_attachments[].meta.original	objectnullable	Size of the file at `url`.
posts[].reblog.media_attachments[].meta.original.width	numbernullable	Width in pixels.
posts[].reblog.media_attachments[].meta.original.height	numbernullable	Height in pixels.
posts[].reblog.media_attachments[].meta.original.aspect	numbernullable	Width / height; null when not reported (videos).
posts[].reblog.media_attachments[].meta.original.duration	numbernullable	Length in seconds, for video and audio; else null.
posts[].reblog.media_attachments[].meta.small	objectnullable	Size of the image at `preview_url`.
posts[].reblog.media_attachments[].meta.small.width	numbernullable	Width in pixels.
posts[].reblog.media_attachments[].meta.small.height	numbernullable	Height in pixels.
posts[].reblog.media_attachments[].meta.small.aspect	numbernullable	Width / height; null when not reported (videos).
posts[].reblog.media_attachments[].meta.small.duration	numbernullable	Length in seconds, for video and audio; else null.
posts[].reblog.card	objectnullable	Link preview for the first link in the post; null if none.
posts[].reblog.card.url	string	The linked page.
posts[].reblog.card.title	stringnullable	Page title.
posts[].reblog.card.description	stringnullable	Page description.
posts[].reblog.card.type	stringnullable	`link`, `video`, `photo` or `rich`.
posts[].reblog.card.provider_name	stringnullable	Site name, e.g. `x.com`.
posts[].reblog.card.image	stringnullable	Preview image URL (hosted by Truth Social).
posts[].reblog.group	objectnullable	The group it was posted in; null for ordinary posts.
posts[].reblog.group.id	string	Group id.
posts[].reblog.group.display_name	string	Group name.
posts[].reblog.group.slug	stringnullable	URL name, e.g. `republicans`.
posts[].reblog.group.url	stringnullable	Group on truthsocial.com.
posts[].reblog.group.members_count	numbernullable	Members.
posts[].reblog.mentions	object[]	Accounts mentioned.
posts[].reblog.mentions[].id	string	Account id.
posts[].reblog.mentions[].username	string	Username without @.
posts[].reblog.mentions[].acct	string	Same as username.
posts[].reblog.mentions[].url	string	Profile on truthsocial.com.
posts[].reblog.tags	object[]	Hashtags used.
posts[].reblog.tags[].name	string	Hashtag without #.
posts[].reblog.tags[].url	string	Hashtag page on truthsocial.com.
posts[].reblog.account	object	The author.
posts[].reblog.account.id	string	Account id.
posts[].reblog.account.username	string	Username without @.
posts[].reblog.account.acct	string	Same as username.
posts[].reblog.account.display_name	string	Display name.
posts[].reblog.account.url	string	Profile on truthsocial.com.
posts[].reblog.account.avatar	stringnullable	Profile picture URL; null if none.
posts[].reblog.account.verified	boolean	Has the verified badge.
posts[].reblog.account.followers_count	number	Followers.
posts[].quote	objectnullable	On a quote post: the quoted post. null otherwise.
posts[].quote.id	string	Post id, e.g. `117351985093810875`.
posts[].quote.created_at	string	Posted at, ISO 8601.
posts[].quote.url	string	The post on truthsocial.com.
posts[].quote.content	stringoptional	Post text as HTML. Omitted with trim=true.
posts[].quote.text	string	Post text, plain. Empty for media-only posts and plain reposts.
posts[].quote.title	stringnullable	Title, on group posts that have one; else null.
posts[].quote.language	stringnullable	Language code (e.g. `en`) when detected; often null.
posts[].quote.visibility	string	`public`, or `group` for posts in a group.
posts[].quote.sensitive	boolean	Marked sensitive (media hidden behind a warning).
posts[].quote.spoiler_text	string	Content warning; empty if none.
posts[].quote.in_reply_to_id	stringnullable	The post this replies to; null if not a reply.
posts[].quote.in_reply_to_account_id	stringnullable	Author of the post this replies to.
posts[].quote.quote_id	stringnullable	The quoted post's id; null if not a quote.
posts[].quote.replies_count	number	Replies.
posts[].quote.reblogs_count	number	ReTruths (reposts).
posts[].quote.favourites_count	number	Likes.
posts[].quote.upvotes_count	numbernullable	Upvotes (Truth Social's likes); null if not reported.
posts[].quote.downvotes_count	numbernullable	Downvotes; null if not reported.
posts[].quote.edited_at	stringnullable	Last edit, ISO 8601; null if never edited.
posts[].quote.media_attachments	object[]	Images and videos, in order.
posts[].quote.media_attachments[].id	string	Attachment id.
posts[].quote.media_attachments[].type	string	`image`, `video`, `gifv`, `audio` or `unknown`.
posts[].quote.media_attachments[].url	stringnullable	The file (full-size image or MP4).
posts[].quote.media_attachments[].preview_url	stringnullable	A smaller image, or the video's thumbnail.
posts[].quote.media_attachments[].description	stringnullable	Alt text; null if none.
posts[].quote.media_attachments[].meta	object	Sizes, as Mastodon reports them.
posts[].quote.media_attachments[].meta.original	objectnullable	Size of the file at `url`.
posts[].quote.media_attachments[].meta.original.width	numbernullable	Width in pixels.
posts[].quote.media_attachments[].meta.original.height	numbernullable	Height in pixels.
posts[].quote.media_attachments[].meta.original.aspect	numbernullable	Width / height; null when not reported (videos).
posts[].quote.media_attachments[].meta.original.duration	numbernullable	Length in seconds, for video and audio; else null.
posts[].quote.media_attachments[].meta.small	objectnullable	Size of the image at `preview_url`.
posts[].quote.media_attachments[].meta.small.width	numbernullable	Width in pixels.
posts[].quote.media_attachments[].meta.small.height	numbernullable	Height in pixels.
posts[].quote.media_attachments[].meta.small.aspect	numbernullable	Width / height; null when not reported (videos).
posts[].quote.media_attachments[].meta.small.duration	numbernullable	Length in seconds, for video and audio; else null.
posts[].quote.card	objectnullable	Link preview for the first link in the post; null if none.
posts[].quote.card.url	string	The linked page.
posts[].quote.card.title	stringnullable	Page title.
posts[].quote.card.description	stringnullable	Page description.
posts[].quote.card.type	stringnullable	`link`, `video`, `photo` or `rich`.
posts[].quote.card.provider_name	stringnullable	Site name, e.g. `x.com`.
posts[].quote.card.image	stringnullable	Preview image URL (hosted by Truth Social).
posts[].quote.group	objectnullable	The group it was posted in; null for ordinary posts.
posts[].quote.group.id	string	Group id.
posts[].quote.group.display_name	string	Group name.
posts[].quote.group.slug	stringnullable	URL name, e.g. `republicans`.
posts[].quote.group.url	stringnullable	Group on truthsocial.com.
posts[].quote.group.members_count	numbernullable	Members.
posts[].quote.mentions	object[]	Accounts mentioned.
posts[].quote.mentions[].id	string	Account id.
posts[].quote.mentions[].username	string	Username without @.
posts[].quote.mentions[].acct	string	Same as username.
posts[].quote.mentions[].url	string	Profile on truthsocial.com.
posts[].quote.tags	object[]	Hashtags used.
posts[].quote.tags[].name	string	Hashtag without #.
posts[].quote.tags[].url	string	Hashtag page on truthsocial.com.
posts[].quote.account	object	The author.
posts[].quote.account.id	string	Account id.
posts[].quote.account.username	string	Username without @.
posts[].quote.account.acct	string	Same as username.
posts[].quote.account.display_name	string	Display name.
posts[].quote.account.url	string	Profile on truthsocial.com.
posts[].quote.account.avatar	stringnullable	Profile picture URL; null if none.
posts[].quote.account.verified	boolean	Has the verified badge.
posts[].quote.account.followers_count	number	Followers.
next_max_id	stringnullable	Pass as `next_max_id` for older posts. null when this page is empty.

Caching and freshness

Responses are cached for up to 2 minutes, so a repeat call within that window can return the same data. It still costs 1 credit.

Errors

Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.

Status	Code	Meaning
401	`missing_api_key`	No API key. Send it in the `x-api-key` header.
401	`invalid_api_key`	The key is unknown or was revoked.
402	`insufficient_credits`	Not enough credits for this call. Buy a pack or wait for tomorrow's top-up.
403	`not_public`	The platform confirmed this account or content isn't available to logged-out visitors. Use a publicly visible target.
404	`not_found`	The endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked.
405	`method_not_allowed`	Endpoints take GET with query params.
429	`rate_limited`	Too many calls at once. Wait for the `retry-after` seconds, then retry.
500	`internal_error`	Something broke on our side. Retry; 5xx errors are free.
502	`upstream_error`	The platform didn't give a usable answer. Retry; 5xx errors are free.
503	`upstream_busy`	All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free.
504	`upstream_timeout`	The platform took over 30 seconds to answer. Retry; timeouts are free.

Use it in Claude

Once LurkAPI is connected to Claude, this endpoint is the truthsocial_user_posts tool. Ask in plain English, for example:

Ask Claude

Use LurkAPI's truthsocial_user_posts with handle "realDonaldTrump" and summarize what you find.

Claude calls truthsocial_user_posts with arguments like these, and each call costs 1 credit:

Tool arguments

{
  "handle": "realDonaldTrump"
}

Tool results skip nulls and empty lists to save tokens, and trim defaults to true.