Profile

GET/v1/truthsocial/profile1 credit

Returns a Truth Social account: display name, bio, avatar and header images, follower, following and post counts, verification, website, creation date and last post date.

01Query parameters

Name	Type	Description
handlerequired	string	The username without `@`, e.g. `realDonaldTrump` (a leading `@` or a profile URL is also accepted).

02Request

curl "https://api.scrapesocial.ai/v1/truthsocial/profile?handle=realDonaldTrump" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/truthsocial/profile?handle=realDonaldTrump

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "107780257626128497",
  "username": "realDonaldTrump",
  "acct": "realDonaldTrump",
  "display_name": "Donald J. Trump",
  "locked": false,
  "bot": false,
  "discoverable": null,
  "group": false,
  "created_at": "2022-02-11T16:16:57.705Z",
  "note": "<p></p>",
  "url": "https://truthsocial.com/@realDonaldTrump",
  "avatar": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg",
  "avatar_static": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg",
  "header": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg",
  "header_static": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg",
  "followers_count": 13132450,
  "following_count": 69,
  "statuses_count": 37558,
  "last_status_at": "2026-10-25",
  "verified": true,
  "location": "",
  "website": "www.DonaldJTrump.com",
  "accepting_messages": false,
  "chats_onboarded": true,
  "feeds_onboarded": true,
  "tv_onboarded": false,
  "bookmarks_onboarded": true,
  "show_nonmember_group_statuses": false,
  "pleroma": {
    "accepts_chat_messages": false
  },
  "tv_account": false,
  "receive_only_follow_mentions": false,
  "group_reactions_onboarded": true,
  "premium": true,
  "accepted_status_edit_prompt": true,
  "emojis": [],
  "fields": []
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The account fields are at the top level of the answer. An unknown account is a free 404. Truth Social shows most accounts only to signed-in users; prominent public accounts work, others may return a free 403.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.