truthsocial.com APItruthsocial.com ↗
Fetch public Truth Social profiles and timelines via two endpoints. Get follower counts, verification status, post content, engagement metrics, and media attachments.
curl -X GET 'https://api.parse.bot/scraper/8d50a43e-b451-45b1-92c5-f709162d4576/get_account' \ -H 'X-API-Key: $PARSE_API_KEY'
Get public profile information for a Truth Social account by username. Returns account metadata including follower counts, verification status, and profile details.
| Param | Type | Description |
|---|---|---|
| usernamerequired | string | Truth Social username without the @ prefix (e.g. realDonaldTrump). |
{
"type": "object",
"fields": {
"id": "string",
"url": "string",
"note": "string",
"avatar": "string",
"header": "string",
"website": "string",
"location": "string",
"username": "string",
"verified": "boolean",
"created_at": "string",
"display_name": "string",
"last_status_at": "string",
"statuses_count": "integer",
"followers_count": "integer",
"following_count": "integer"
},
"sample": {
"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-06",
"statuses_count": 34120,
"followers_count": 12764879,
"following_count": 69
}
}About the truthsocial.com 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.
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.
- 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 | 250 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.