UnifAPI Docs

List posts from a Truth Social profile

Returns recent posts (truths) from a public Truth Social profile, newest first, with engagement counts and media. Paginate with `cursor`.

Pricing — $ · min $0.006

Minimum 6 credits ($0.006) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/truth-social/users/{username}/posts

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

username*string

Truth Social username or numeric account id.

Length1 <= length <= 500

Query Parameters

limit?string

Maximum posts to return (1–20). Default: 20.

Length1 <= length
cursor?string

Opaque pagination cursor from a previous response's pagination.next_cursor. Omit for the first page.

Length1 <= length <= 16384

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/truth-social/users/string/posts"
{  "request_id": "string",  "data": [    {      "id": "string",      "url": "string",      "created_at": 0,      "edited_at": 0,      "text": "string",      "spoiler_text": "string",      "language": "string",      "visibility": "string",      "is_sensitive": true,      "author": {        "platform": "string",        "id": "string",        "username": "string",        "display_name": "string",        "avatar_url": "string",        "is_verified": true,        "profile_url": "string"      },      "in_reply_to_status_id": "string",      "in_reply_to_account_id": "string",      "quote_id": "string",      "repost_of_id": "string",      "reply_count": 0,      "repost_count": 0,      "favorite_count": 0,      "upvote_count": 0,      "downvote_count": 0,      "media": [        {          "type": "string",          "url": "string",          "preview_url": "string",          "description": "string",          "width": 0,          "height": 0,          "duration": 0        }      ],      "link_preview": {        "url": "string",        "title": "string",        "description": "string",        "provider_name": "string",        "image_url": "string"      },      "poll": {        "expires_at": 0,        "is_expired": true,        "is_multiple": true,        "votes_count": 0,        "options": [          {            "title": "string",            "votes_count": 0          }        ]      },      "quote": {        "id": "string",        "url": "string",        "text": "string",        "author_handle": "string"      }    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}