Get Truth Social profiles and posts

Profile

GET /v1/truthsocial/profile requires handle, with or without @. username is an alias. Accounts that do not exist answer not_found. A bad parameter is invalid_params. Neither is retryable.

The recorded request uses a handle.

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}

data

is a profile. platform is truthsocial. The shared fields are id, handle, name, headline, url, bio, avatar_url, banner_url, verified, is_private, external_url, links, location, category and created_at. Null means the page did not include that value.

stats.followers, stats.following and stats.posts

are the counts. stats.likes and stats.views are null when the profile has no such numbers. Do not store null as zero.

extra

on the recorded profile includes accepting_messages, acct, is_bot, is_group, is_premium, is_tv_account and last_status_at. id on the profile is the numeric user id. Keep it. The posts endpoint can take that id and skip a second lookup.

Posts

GET /v1/truthsocial/profile/posts lists the account's own posts, newest first. ReTruths are left out. Send handle or id. One of them is required. id is the numeric user id from the profile. user_id aliases id. cursor pages.

1curl -G "https://api.socialscrape.dev/v1/truthsocial/profile/posts" \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/posts",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/posts");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}

Each item is a post: id, url, text, published_at, author, media, stats. stats.likes, stats.comments and stats.shares are filled when the post has them. stats.views and stats.saves are null when absent.

Truth Social's own votes are not squeezed into likes. They are extra.upvotes and extra.downvotes. extra also has card, links and visibility.

data.cursor and data.has_more, and the same fields on the envelope, control paging. Pass cursor back unchanged until has_more is false. Each page is 1 credit. The loop is in pagination. parent is the account.

One post by URL is GET /v1/truthsocial/post. The parameter is url, shaped like truthsocial.com/@user/<id>. That response is a single post with the same stat and extra fields. Use it when you already have a link and do not need the feed.