Skip to content
scrapeatlas.Dashboard

Social networks

Truth Social API

Retrieve public Truth Social profiles, paginated user timelines and individual posts as unchanged source records with derived plain text.

3 endpointsx-api-key

Three authenticated endpoints return the same source records Truth Social serves, plus a plain-text field, a caller-carried cursor and explicit coverage.

API availability: Available

Base URL · local workerhttp://localhost:3027Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

GET/v1/truthsocial/profile

Get a Truth Social profile

Retrieve a public Truth Social account by username. The complete source account record is returned unchanged: ID, names, bio, images, follower/following/post counts, verification and every other published field, in source order.

Reference
GET/v1/truthsocial/user/posts

Get a Truth Social user’s posts

Retrieve a page of public timeline posts, newest first, excluding replies. Provide handle or user_id and pass next_max_id for the next page. Use trim for compact records.

Reference
GET/v1/truthsocial/post

Get a Truth Social post

Retrieve one public post from its URL. The complete source record is returned unchanged with a derived text field; the post ID and author must match the URL.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

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

Coverage & limits

  • Independent worker on port 3027, TRUTHSOCIAL_API_KEY in x-api-key. No login, persistent cookies, proxy, storage, media download or product dependencies.
  • Two concurrent operations, 25-second total deadline, at most three upstream document reads per operation (handle lookup, timeline or post, and one shared transient retry). Challenges, sign-in requirements and throttling are not retried.
  • Headed Patchright Chromium with page JavaScript disabled reads only the requested truthsocial.com JSON document; redirect destinations and subresources are blocked. Linux requires Xvfb; readiness checks the browser binary and display.
  • Combined 4 MiB decoded JSON per operation, 100,000 parsed nodes, depth 64 and the source page size of 20 posts. Timelines carry the account's own posts in source order.
  • Source records are returned unchanged in source order. Only text (derived) and our envelope fields are added; nothing is renamed, defaulted or removed. Restricted accounts answer restricted_page.
  • Every response is fetched live; media is returned as URLs.
Error codes
12
HTTPfailure.codeMeaning
400invalid_requestMissing, duplicate, ambiguous or unsupported parameters, or an unsupported post URL.
401unauthorizedInvalid API key.
403restricted_pageThe record requires a signed-in Truth Social session.
404not_foundUnknown account or post.
429upstream_rate_limitedSource throttled retrieval.
502upstream_challengedThe source edge blocked the request (status challenged).
502unsupported_pageMissing, malformed or mismatched source data, including a username or post identity that differs from the request.
502response_too_large payload_too_complexSource exceeds parsing limits.
502unsafe_redirect upstream_error request_limitBounded retrieval failed.
503busyAll slots occupied.
504timeoutTotal deadline exceeded.
200partialMalformed timeline entries were omitted (malformed_posts_omitted).