Truth Social APItruthsocial.com ↗
Fetch public Truth Social profiles and timelines via two endpoints. Get follower counts, verification status, post content, engagement metrics, and media attachments.
What is the Truth Social API?
The Truth Social API covers 2 endpoints that give you structured access to public account data and post timelines on truthsocial.com. The get_account endpoint returns 10 profile fields including follower counts, verification status, avatar, and bio. The get_posts endpoint returns paginated post arrays with content, engagement metrics, and media attachments — with cursor-based pagination to walk back through a full account history.
curl -X GET 'https://api.parse.bot/scraper/8d50a43e-b451-45b1-92c5-f709162d4576/get_account?username=realDonaldTrump' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace truthsocial-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Truth Social API — fetch public profiles and recent posts.
"""
from parse_apis.truth_social_api import TruthSocial, Account, Post
client = TruthSocial()
# Fetch account profile
account = client.accounts.get(username="realDonaldTrump")
print(account.display_name, account.followers_count, account.verified)
# Browse recent posts via the account's sub-resource-style operation
for post in account.posts(exclude_replies="true", limit=5):
print(post.id, post.created_at, post.replies_count, post.reblogs_count)
Get public profile information for a Truth Social account by username. Returns account metadata including follower counts, verification status, and profile details. One network round-trip per call.
| Param | Type | Description |
|---|---|---|
| usernamerequired | string | Truth Social username without the @ prefix (e.g. realDonaldTrump). |
{
"type": "object",
"fields": {
"id": "string account ID",
"url": "string profile URL",
"note": "string HTML bio",
"avatar": "string avatar image URL",
"header": "string header image URL",
"website": "string website URL",
"location": "string location",
"username": "string username",
"verified": "boolean verification status",
"created_at": "string ISO 8601 timestamp",
"display_name": "string display name",
"last_status_at": "string date of last post (YYYY-MM-DD)",
"statuses_count": "integer total post count",
"followers_count": "integer follower count",
"following_count": "integer following count"
},
"sample": {
"data": {
"id": "107780257626128497",
"url": "https://truthsocial.com/@realDonaldTrump",
"note": "<p></p>",
"avatar": "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",
"website": "www.DonaldJTrump.com",
"location": "",
"username": "realDonaldTrump",
"verified": true,
"created_at": "2022-02-11T16:16:57.705Z",
"display_name": "Donald J. Trump",
"last_status_at": "2026-06-10",
"statuses_count": 34200,
"followers_count": 12782288,
"following_count": 69
},
"status": "success"
}
}About the Truth Social API
Account Profiles
The get_account endpoint accepts a username string (without the @ prefix, e.g. realDonaldTrump) and returns a fixed set of public profile fields: id, username, url, note (bio text), avatar, header image, website, location, verified boolean, and created_at timestamp. This covers enough to build a profile card or track verification status changes over time.
Post Timelines
The get_posts endpoint returns posts in reverse chronological order for a given username. Each response contains a posts array of post objects with id, content, and engagement metrics, plus account_id and a next_max_id cursor for pagination. You can pass max_id to resume from a prior position, set limit between 1 and 40 to control page size, and optionally set exclude_replies to true or false to filter out reply posts. The cursor pattern lets you walk backward through an account's full public timeline request by request.
Coverage and Freshness
Both endpoints operate against public Truth Social profiles — no account authentication is required on the caller's side. Data freshness reflects whatever is publicly visible on the platform at query time. Private or suspended accounts are not accessible; only public-facing profile fields and timeline posts are returned.
The Truth Social API is a managed, monitored endpoint for truthsocial.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when truthsocial.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official truthsocial.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor a public figure's Truth Social posts in real time using
get_postswith cursor pagination - Track follower count trends over time by polling
get_accounton a schedule - Check the
verifiedfield to confirm account authenticity before ingesting content - Aggregate post engagement metrics across multiple accounts for media analysis
- Build a cross-platform social feed that includes Truth Social alongside other networks
- Alert on new posts from a specific username by comparing the latest
idfrom successiveget_postscalls - Extract profile metadata such as
websiteandlocationfor journalist or researcher contact databases
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Truth Social have an official developer API?+
What does `get_account` return beyond basic profile text?+
avatar and header image URLs, a website field, location string, verified boolean, created_at timestamp, the account's note (bio), and the canonical url of the profile page — in addition to id and username.How does pagination work in `get_posts`?+
get_posts response includes a next_max_id string. Pass that value as the max_id parameter in your next request to retrieve the next page of older posts. Setting limit (1–40) controls how many posts appear per page. There is no offset-based pagination.Does the API return follower and following counts?+
get_account endpoint returns profile metadata including verified, note, website, location, avatar, and created_at, but numeric follower, following, and post-count fields are not part of the current response schema. You can fork this API on Parse and revise it to add those fields if they become accessible.Can I search for posts by keyword or hashtag rather than by username?+
username — get_account for profile data and get_posts for that account's timeline. Keyword or hashtag search across Truth Social is not covered. You can fork this API on Parse and revise it to add a search endpoint.