Truth Social scraper API
Resolve public Truth Social profiles and posts over REST with the same JSON envelope as TikTok, Instagram, and Telegram.
3 endpointsWhy teams use Social Fetch for Truth Social
Truth Social is a high-signal source for political and news chatter that often never appears on X or Facebook in the same form. Homegrown scrapers and one-off parsers still leave you with a second auth story, ad-hoc status URL handling, and opaque pagination beside the marketplace key you already ship.
Social Fetch exposes three typed routes under `/v1/truthsocial`: profile by handle, cursor-paginated profile posts, and a single post by public status URL. Every response uses the normalized `{ data, meta }` envelope — `data.lookupStatus`, ISO timestamps, author cards, media and link previews when present, `meta.requestId`, and `meta.creditsCharged`.
Coverage is public Truth Social content only. Missing handles and deleted statuses resolve as typed `not_found`, not an empty 200 that looks like a blank page. Use Truth Social's own product for posting or account management; use these routes when Truth Social is one enrichment source beside other networks on a shared marketplace key.
What Truth Social data can you get?
- Public Truth Social profile by handle — display name, bio, avatar, verification, and follower metrics when present.
- Cursor-paginated public posts for a profile handle.
- Single post lookup by `@handle/{id}` or `@handle/posts/{id}` URL.
- `data.lookupStatus` of `found` or `not_found` so misses stay typed.
- Same Social Fetch API key and `{ data, meta }` envelope as the rest of the marketplace.
Truth Social API endpoints
Routes from the live API catalog. Open an endpoint for parameters and examples — credit notes come from OpenAPI pricing extensions.
How to call the Truth Social API
1. Create an API key
Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits — enough to smoke-test several live Truth Social handles before you wire batch jobs.
2. Call a Truth Social route
Start with `GET /v1/truthsocial/profiles/{handle}` for the profile card, then `.../posts` for the feed or `GET /v1/truthsocial/posts?url=` for one status. Send `x-api-key` on every request.
3. Branch on lookupStatus
Persist rows only when `data.lookupStatus` is `found`. Log `meta.requestId`; bill from `meta.creditsCharged`. Page older posts with the opaque `cursor` while `data.hasMore` is true.
How much does the Truth Social API cost?
Each Truth Social route charges a fixed credit amount per successful completed lookup: profile **2**, single post **2**, profile posts **3** (including cursor continuations). Credits never expire on pay-as-you-go packs. Confirm every response with `meta.creditsCharged` — that field is the billing source of truth.
Social Fetch vs the official Truth Social API
Truth Social's own product and any first-party partner APIs (when available) are the right path for posting, DMs, and account management. Social Fetch is public-content enrichment only: handle or status URL in, structured JSON out, no Truth Social login. Choose first-party tools for write and account workflows; choose Social Fetch when you already meter multi-network enrichment on one REST key.
Truth Social API FAQ
Is there a Truth Social scraper API / Truth Social data API?
Yes. Social Fetch provides profile, profile-posts, and post routes under `/v1/truthsocial`. Authenticate with a Social Fetch API key (`x-api-key`). You do not need a Truth Social login for these public lookups.
What Truth Social data does Social Fetch return?
On `lookupStatus: found`, profile responses include presentation fields and metrics; posts include text, author, media, link previews, and engagement counts when present. Exact fields live under `/docs/api` and on this hub's endpoint pages. Missing handles or statuses return `not_found`.
What handle and URL formats do the routes accept?
Pass the public Truth Social username used on `truthsocial.com/@{handle}` — with or without a leading `@` — or pass the account id on profile routes. For a single post, pass the full public status URL.
How much does the Truth Social API cost?
You buy credit packs (or use the 100 free signup credits). Truth Social charges 2 credits per lookup (profile, post, or profile posts; 4 with includeReplies=true). Always check `meta.creditsCharged`. There is no required monthly subscription for pay-as-you-go packs.
Can I access private or locked Truth Social accounts?
No. Only publicly visible profiles and statuses. Restricted or missing targets resolve through `data.lookupStatus` (for example `not_found`) rather than inventing empty post lists.
Does HTTP 200 always mean the profile or post was found?
No. HTTP 200 means the request finished. Check `data.lookupStatus`: `found` means you got data; `not_found` means the handle or status did not resolve. Persist `meta.requestId` when you need to debug a miss.
Can I use Truth Social routes from agents or MCP?
Yes. The same operations appear as typed MCP tools and can be reached via Ask (`POST /v1/ask`) for plain-English exploration. For production jobs, pin the typed `/v1/truthsocial` routes so routing stays explicit.
Is scraping Truth Social data legal?
Social Fetch returns publicly visible data. You are responsible for how you use it under Truth Social's terms, applicable law, and your own compliance review. We do not give legal advice.
Start with Truth Social data
Create an account, spend the 100 free credits on live Truth Social routes, then buy a pack when the JSON fits your pipeline. Credits do not expire on pay-as-you-go packs.