Skip to content

Structured Truth Social data: send handles. Single lookup, 1 credit per successful call.

GET · POST1 credit / successful callSingle lookup
GEThttps://api.scrapier.io/api/v2/truthsocial-profile-info/Open in Playground

Call GET /api/v2/truthsocial-profile-info/ with handles. The results are in data.profile. 6 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/truthsocial-profile-info/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "handles=realDonaldTrump" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
handlesstringyese.g. realDonaldTrumpThe Truth Social account: "realDonaldTrump", "@realDonaldTrump", a profile URL (https://truthsocial.com/@realDonaldTrump, a /<status id> tail or the /users/<name> form is fine) or [email protected]; case does not matter -> ONE profile record: the public Account entity verbatim (id, username, display_name, note / bio, avatar / header, followers_count, following_count, statuses_count, created_at, verified, premium, website ...), likes_count (likes received) and computed{engagement_rate, language, content_category}. Single lookup: next_cursor is always null. An unknown / suspended / moved account answers a status record (not_found | account_suspended | moved | invalid_input) + status_note.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
compute_metricsbooleannotruetrue (default) = sample the latest feed_sample original truths for computed.language / engagement_rate / content_category. false = profile only (1 request; engagement_rate / language null, category from the bio).
locked in cursor
feed_sampleintegerno20Original truths sampled for the computed block (1..100, default 20 = one statuses page).
locked in cursor
count_likesbooleannotruetrue (default) = walk the status history (~20 a call) and sum favourites_count -> likes_count (likes received). false = likes_count null.
locked in cursor
likes_max_postsintegerno100Cap on the likes walk in statuses seen (default 100 = 5 pages). Capped at 600 (30 pages, ~20 s proxied) plus a 60 s wall-clock budget on the walk: past either likes_count is a lower bound (stats.likes_count_complete false + warning). Cloudflare allows ~6 statuses calls / minute / IP - proxied the walk hops to a fresh US exit, direct it sleeps.
locked in cursor
statuses_per_minuteintegerno6Statuses requests per minute the scraper paces itself to (default 6).
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"handles": "@truthsocial",
"profile": {
"input_handle": "@truthsocial",
"handle": "truthsocial",
"account_id": "107759501782461327",
"status": "ok",
"status_note": null,
"http_status": 200,
"id": "107759501782461327",
"username": "truthsocial",
"acct": "truthsocial",
"display_name": "Truth Social — $DJT",
"locked": false,
"bot": false,
"discoverable": null,
"group": false,
"created_at": "2022-02-08T00:18:27.696Z",
"note": "<p>Official page of TRUTH Social.</p>",
"url": "https://truthsocial.com/@truthsocial",
"avatar": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/759/501/782/461/327/original/4bea7f408ea74952.jpeg",
"avatar_static": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/759/501/782/461/327/original/4bea7f408ea74952.jpeg",
"header": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/759/501/782/461/327/original/238a02dff6f7342d.jpeg",
"header_static": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/759/501/782/461/327/original/238a02dff6f7342d.jpeg",
"followers_count": 6682749,
"following_count": 5,
"statuses_count": 1369,
"last_status_at": "2026-09-10",
"verified": true,
"location": "",
"website": "https://truthsocial.com",
"accepting_messages": true,
"chats_onboarded": true,
"feeds_onboarded": true,
"tv_onboarded": true,
"bookmarks_onboarded": false,
"show_nonmember_group_statuses": true,
"pleroma": {
"accepts_chat_messages": true
},
"tv_account": false,
"receive_only_follow_mentions": false,
"group_reactions_onboarded": true,
"premium": true,
"accepted_status_edit_prompt": true,
"emojis": [],
"fields": [],
"bio": "Official page of TRUTH Social.",
"likes_count": null,
"computed": {
"engagement_rate": 0.0491,
"language": "en",
"content_category": "business"
},
"partial": false,
"warnings": [],
"stats": {
"requests": 4,
"retries": 0,
"api_calls": 4,
"rotations": 0,
"proxy": true,
"ratelimit_remaining": 299,
"statuses_pages": 3,
"statuses_seen": 42,
"posts_sampled": 12,
"feed_sample": 20,
"language_source": "post_text+language_tag",
"category_keywords": [
"ceo",
"company",
"financial"
]
},
"duration_ms": 2629,
"scraped_at": "2026-09-22T10:44:51.302Z"
},
"next_cursor": null
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.profile.

FieldTypeExampleDescription
handlesstring@truthsocial—
profileobject{…}The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
profile.input_handlestring@truthsocial—
profile.handlestringtruthsocial—
profile.account_idstring107759501782461327—
profile.statusstringok—
profile.status_notenullnull—
profile.http_statusinteger200—
profile.idstring107759501782461327—
profile.usernamestringtruthsocial—
profile.acctstringtruthsocial—
profile.display_namestringTruth Social — $DJT—
profile.lockedbooleanfalse—
profile.botbooleanfalse—
profile.discoverablenullnull—
profile.groupbooleanfalse—
profile.created_atstring2022-02-08T00:18:27.696Z—
profile.notestring<p>Official page of TRUTH Social.</p>—
profile.urlstringhttps://truthsocial.com/@truthsocial—
profile.avatarstringhttps://static-assets-1.truthsocial.com/tmtg:…—
profile.avatar_staticstringhttps://static-assets-1.truthsocial.com/tmtg:…—
profile.headerstringhttps://static-assets-1.truthsocial.com/tmtg:…—
profile.header_staticstringhttps://static-assets-1.truthsocial.com/tmtg:…—
profile.followers_countinteger6682749—
profile.following_countinteger5—
profile.statuses_countinteger1369—
profile.last_status_atstring2026-09-10—
profile.verifiedbooleantrue—
profile.locationstring—
profile.websitestringhttps://truthsocial.com—
profile.accepting_messagesbooleantrue—
profile.chats_onboardedbooleantrue—
profile.feeds_onboardedbooleantrue—
profile.tv_onboardedbooleantrue—
profile.bookmarks_onboardedbooleanfalse—
profile.show_nonmember_group_statusesbooleantrue—
profile.pleromaobject{…}—
profile.tv_accountbooleanfalse—
profile.receive_only_follow_mentionsbooleanfalse—
profile.group_reactions_onboardedbooleantrue—
profile.premiumbooleantrue—
profile.accepted_status_edit_promptbooleantrue—
profile.emojisarray[]—
profile.fieldsarray[]—
profile.biostringOfficial page of TRUTH Social.—
profile.likes_countnullnull—
profile.computedobject{…}—
profile.partialbooleanfalse—
profile.warningsarray[]—
profile.statsobject{…}—
profile.duration_msinteger2629—
profile.scraped_atstring2026-09-22T10:44:51.302Z—

Returns everything in one call; next_cursor is always null.

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Nothing special: send the inputs, read the result.
  • Truth Social Posts — Structured Truth Social data: send usernames. Cursor-paginated, 1 credit per successful call.
  • Truth Social Profile Info — Structured Truth Social data: send handles. Single lookup, 1 credit per successful call.
  • Truth Social Single Post — Structured Truth Social data: send urls. Single lookup, 1 credit per successful call.