{"id":"b9db3156-d5f8-4504-82ac-029b4d0219ab","slug":"truthsocial-com-api","name":"truthsocial.com API","description":"Retrieve public profiles and recent posts from Truth Social to monitor accounts and stay updated on the latest content. Access account information and timelines directly without leaving your application.","front_facing_description":"Retrieve public profiles and recent posts from Truth Social to monitor accounts and stay updated on the latest content. Access account information and timelines directly without leaving your application.","source_url":"http://truthsocial.com/@realDonaldTrump","is_authenticated":false,"canonical_scraper_id":"8d50a43e-b451-45b1-92c5-f709162d4576","apis":[{"method":"GET","endpoint_name":"get_account","description":"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.","input_params":{"username":{"type":"string","required":true,"description":"Truth Social username without the @ prefix (e.g. realDonaldTrump).","domain":{"kind":"open","example":"realDonaldTrump","pattern":"^[a-zA-Z0-9_]+$","generator":{"type":"static","value":"realDonaldTrump"}}}},"return_schema":{"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"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.id","op":"not_null"},{"path":"$.data.username","op":"not_null"},{"path":"$.data.followers_count","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_posts","description":"Get recent posts (truths) for a Truth Social account in reverse chronological order. Returns post content, engagement metrics, and media attachments. Supports cursor-based pagination via next_max_id. Each call costs two round-trips: one account lookup plus one statuses fetch.","input_params":{"limit":{"type":"integer","required":false,"description":"Number of posts to return per page. Must be between 1 and 40.","default":20,"enum":"Limit","closed":true,"domain":{"kind":"enum","values":[5,10,20,40],"generator":{"type":"enum_pick","strategy":"first"}}},"max_id":{"type":"string","required":false,"description":"Return posts older than this post ID for pagination. Use next_max_id from a previous response."},"username":{"type":"string","required":true,"description":"Truth Social username without the @ prefix (e.g. realDonaldTrump).","domain":{"kind":"open","example":"realDonaldTrump","pattern":"^[a-zA-Z0-9_]+$","generator":{"type":"static","value":"realDonaldTrump"}}},"exclude_replies":{"type":"string","required":false,"description":"Whether to exclude replies. Accepts: true, false.","default":"true","enum":"ExcludeReplies","closed":true,"domain":{"kind":"enum","values":["true","false"],"generator":{"type":"enum_pick","strategy":"first"}}}},"return_schema":{"type":"object","fields":{"posts":"array of post objects with id, content, engagement metrics, and media","account_id":"string account ID","next_max_id":"string or null, post ID for next page pagination"},"sample":{"data":{"posts":[{"id":"116727075577305840","url":"https://truthsocial.com/@realDonaldTrump/116727075577305840","card":null,"content":"<p>Last month, I directed our Great U.S. Military...</p>","language":"en","quote_id":null,"sensitive":false,"created_at":"2026-06-10T17:50:24.111Z","visibility":"public","spoiler_text":"","reblogs_count":8177,"replies_count":4168,"favourites_count":37178,"media_attachments":[]}],"account_id":"107780257626128497","next_max_id":"116725298433622438"},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.posts","op":"array_min_len","value":1},{"path":"$.data.account_id","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"get_posts":{"limit":"5","username":"realDonaldTrump","exclude_replies":"true"},"get_account":{"username":"realDonaldTrump"}},"prefill_inputs":{"get_account":{"username":"realDonaldTrump"},"get_posts":{"limit":"5","username":"realDonaldTrump","exclude_replies":"true"}},"last_verified_at":"2026-10-30T21:03:52.897832+00:00","endpoint_health":[{"endpoint_name":"get_account","status":"healthy","last_checked_at":"2026-10-30T21:03:52.897832+00:00","last_verified_at":"2026-10-30T21:03:52.897832+00:00","recent_runs":[{"at":"2026-10-30T21:03:52.897832+00:00","status":"healthy"},{"at":"2026-10-23T20:03:52.915815+00:00","status":"healthy"},{"at":"2026-10-16T19:03:52.890960+00:00","status":"healthy"},{"at":"2026-10-09T18:03:52.930321+00:00","status":"healthy"},{"at":"2026-10-02T18:01:53.021600+00:00","status":"healthy"}]},{"endpoint_name":"get_posts","status":"healthy","last_checked_at":"2026-10-30T21:03:52.897832+00:00","last_verified_at":"2026-10-30T21:03:52.897832+00:00","recent_runs":[{"at":"2026-10-30T21:03:52.897832+00:00","status":"healthy"},{"at":"2026-10-23T20:03:52.915815+00:00","status":"healthy"},{"at":"2026-10-16T19:03:52.890960+00:00","status":"healthy"},{"at":"2026-10-09T18:03:52.930321+00:00","status":"healthy"},{"at":"2026-10-02T18:01:53.021600+00:00","status":"healthy"}]}],"sdk_usage_example":{"code":"\"\"\"\nTruth Social API — fetch public profiles and recent posts.\n\"\"\"\n\nfrom parse_apis.truth_social_api import TruthSocial, Account, Post\n\nclient = TruthSocial()\n\n# Fetch account profile\naccount = client.accounts.get(username=\"realDonaldTrump\")\nprint(account.display_name, account.followers_count, account.verified)\n\n# Browse recent posts via the account's sub-resource-style operation\nfor post in account.posts(exclude_replies=\"true\", limit=5):\n    print(post.id, post.created_at, post.replies_count, post.reblogs_count)\n","shape":"parse_sdk","endpoints":["get_account","get_posts"],"has_session":false,"hover_map":[{"line":14,"col":4,"len":4,"label":"post: Post","kind":"variable"},{"line":7,"col":9,"len":11,"label":"TruthSocial — API client","kind":"class"},{"line":14,"col":20,"len":5,"label":"posts() → List[Post]","kind":"method"},{"line":15,"col":15,"len":2,"label":"id: str","kind":"field"},{"line":15,"col":24,"len":10,"label":"created_at: datetime","kind":"field"},{"line":15,"col":41,"len":13,"label":"replies_count: int","kind":"field"},{"line":15,"col":61,"len":13,"label":"reblogs_count: int","kind":"field"},{"line":15,"col":10,"len":4,"label":"post: Post","kind":"variable"},{"line":15,"col":19,"len":4,"label":"post: Post","kind":"variable"},{"line":15,"col":36,"len":4,"label":"post: Post","kind":"variable"},{"line":15,"col":56,"len":4,"label":"post: Post","kind":"variable"}]},"sdk_delivery_state":"legacy","summary":"Fetch public account profiles and recent posts (truths) from Truth Social.","updated_at":"2026-07-23T02:22:51.524345+00:00","user_variants":[],"latest_version":4,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Truth Social does not publish a documented public developer API or offer API keys to third parties. There is no official developer portal or documented endpoint reference available as of mid-2025.","q":"Does Truth Social have an official developer API?"},{"a":"It returns `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`.","q":"What does `get_account` return beyond basic profile text?"},{"a":"Each `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.","q":"How does pagination work in `get_posts`?"},{"a":"Not currently. The `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.","q":"Does the API return follower and following counts?"},{"a":"Not currently. Both endpoints are scoped to a specific `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.","q":"Can I search for posts by keyword or hashtag rather than by username?"}],"keywords":["truth social api","truthsocial profile api","truth social posts api","fetch truth social timeline","truth social scraper api","realDonaldTrump truth social data","truth social account follower data","truth social verified account api","truth social post engagement metrics","social media monitoring truth social","truth social cursor pagination","truth social public profile data","alternative social media api"],"use_cases":["Monitor a public figure's Truth Social posts in real time using `get_posts` with cursor pagination","Track follower count trends over time by polling `get_account` on a schedule","Check the `verified` field 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 `id` from successive `get_posts` calls","Extract profile metadata such as `website` and `location` for journalist or researcher contact databases"],"meta_title":"Truth Social API – Profiles & Posts","generated_at":"2026-06-06T20:10:53.122521+00:00","lead_paragraph":"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.","schema_version":2,"meta_description":"Fetch public Truth Social profiles and timelines via two endpoints. Get follower counts, verification status, post content, engagement metrics, and media attachments.","primary_category":"social_media","long_description_md":"## Account Profiles\n\nThe `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.\n\n## Post Timelines\n\nThe `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.\n\n## Coverage and Freshness\n\nBoth 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.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["news_media","government_public"]},"primary_category":"social_media","secondary_categories":["news_media","government_public"],"access_requirements":[]}