- Docs
- Truth Social
- Truth Social profile API
Truth Social profile API
Public profile of a Truth Social account.
GET /v1/truthsocial/profile
GET /v1/truthsocial/profile
Public profile of a Truth Social account. Accounts that do not exist answer not_found.
- Cost: 1 credit
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
handle | string | yes | Username, with or without the leading @. Also accepted as username. |
Every request also accepts:
trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request#
Set your key in the environment first (see Authentication).
1curl -G "https://api.socialscrape.dev/v1/truthsocial/profile" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "handle=realDonaldTrump"1import os2import requests34params = {5 "handle": "realDonaldTrump",6}7res = requests.get(8 "https://api.socialscrape.dev/v1/truthsocial/profile",9 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10 params=params,11)12body = res.json()1314if body["ok"]:15 print(body["data"])16else:17 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/truthsocial/profile");2url.search = new URLSearchParams({3 "handle": "realDonaldTrump"4}).toString();5const res = await fetch(url, {6 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11 console.log(body.data);12} else {13 console.error(body.error.code, body.error.message);14}1{2 "nodes": [3 {4 "name": "SocialScrape Truth Social profile",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/truthsocial/profile",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "handle",19 "value": "realDonaldTrump"20 }21 ]22 },23 "sendHeaders": true,24 "headerParameters": {25 "parameters": [26 {27 "name": "x-api-key",28 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29 }30 ]31 }32 }33 }34 ],35 "connections": {}36}Example response#
This is a sample from a recorded response. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 1,4 "credits_remaining": 4999,5 "cached": false,6 "cached_at": null,7 "request_id": "req_befa4b76fa4c540d99f1b7cc",8 "data": {9 "object": "profile",10 "platform": "truthsocial",11 "id": "107780257626128497",12 "handle": "realDonaldTrump",13 "name": "Donald J. Trump",14 "headline": null,15 "url": "https://truthsocial.com/@realDonaldTrump",16 "kind": "person",17 "bio": null,18 "avatar_url": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg",19 "banner_url": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg",20 "verified": true,21 "is_private": false,22 "external_url": "https://www.DonaldJTrump.com",23 "links": null,24 "location": null,25 "category": null,26 "created_at": "2022-02-11T16:16:57.705000Z",27 "stats": {28 "followers": 13141252,29 "following": 69,30 "posts": 37714,31 "likes": null,32 "views": null33 },34 "extra": {35 "accepting_messages": false,36 "acct": "realDonaldTrump",37 "is_bot": false,38 "is_group": false,39 "is_premium": true,40 "is_tv_account": false,41 "last_status_at": "2026-10-29"42 }43 },44 "cursor": null,45 "has_more": null46}Response#
A Profile object in data.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
Every request can also fail with the account and platform errors listed on the Errors page.
Example error:
1{2 "ok": false,3 "error": {4 "code": "not_found",5 "message": "The platform says this profile, post or item does not exist.",6 "retryable": false7 },8 "credits_charged": 0,9 "request_id": "req_39bd20b68961e55da3f22fe1"10}Related endpoints#
- Truth Social profile posts (
GET /v1/truthsocial/profile/posts) - Truth Social post (
GET /v1/truthsocial/post)