Profile

When to use this

Use it to size up an account: followers, following, post count, verification and the date of the latest post. id is what user posts takes as user_id.

Pass handle as a username, @username or a truthsocial.com profile URL.

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.

Example request

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

curl "https://api.lurkapi.com/v1/truthsocial/profile?handle=realDonaldTrump" \
  -H "x-api-key: YOUR_API_KEY"

const params = new URLSearchParams({
  handle: "realDonaldTrump",
});
const res = await fetch(`https://api.lurkapi.com/v1/truthsocial/profile?${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.fields);

import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v1/truthsocial/profile",
    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["fields"])

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

{
  "success": true,
  "credits_remaining": 999998,
  "credits_charged": 1,
  "id": "107780257626128497",
  "username": "realDonaldTrump",
  "acct": "realDonaldTrump",
  "display_name": "Donald J. Trump",
  "note": "<p></p>",
  "note_text": "",
  "url": "https://truthsocial.com/@realDonaldTrump",
  "avatar": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/av…",
  "header": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/he…",
  "website": "www.DonaldJTrump.com",
  "location": null,
  "fields": [],
  "followers_count": 13086927,
  "following_count": 69,
  "statuses_count": 36875,
  "last_status_at": "2026-09-30",
  "verified": true,
  "premium": true,
  "locked": false,
  "bot": false,
  "created_at": "2022-02-11T16:16:57.705Z"
}

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.

Caching and freshness

Responses are cached for up to 10 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.

Use it in Claude

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

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

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

{
  "handle": "realDonaldTrump"
}

Tool results skip nulls and empty lists to save tokens.