User Posts
GET/v1/truthsocial/user/posts1 credit
Returns an account's posts, newest first and 20 per page, each with its HTML `content` and a plain-text `text`, media, counts (replies, reblogs, favourites, upvotes) and creation date.
01Query parameters
| Name | Type | Description |
|---|---|---|
| handleoptional | string | The username, e.g. `realDonaldTrump`. One of `handle` or `user_id` is required. |
| user_idoptional | string | The numeric account id, e.g. `107780257626128497`. One of `handle` or `user_id` is required; `user_id` wins when both are given and answers faster. |
| next_max_idoptional | string | The `next_max_id` value from the previous page, to get the next (older) 20 posts. |
| trimoptional | boolean | Set to `true` to receive each post with only its id, text, date, language, URL, counts and media. Same price.Default: false |
02Request
curl "https://api.scrapesocial.ai/v1/truthsocial/user/posts?handle=realDonaldTrump" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/truthsocial/user/posts?handle=realDonaldTrump
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"posts": [
{
"text": "FoxNews is spending far too much time putting on the OPPONENTS of Republican Party Candidates, people that love our Country, and have Great Policies and Ideas. These American Patriots are being absolutely “blurred out” by the Media, and Fox is doing little to help. That’s the only reason this Race is close, if it is indeed close. President DONALD J. TRUMP",
"id": "117502572828225324",
"created_at": "2026-10-25T16:49:33.086Z",
"in_reply_to_id": null,
"quote_id": null,
"in_reply_to_account_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": "en",
"uri": "https://truthsocial.com/@realDonaldTrump/117502572828225324",
"url": "https://truthsocial.com/@realDonaldTrump/117502572828225324",
"content": "<p>FoxNews is spending far too much time putting on the OPPONENTS of Republican Party Candidates, people that love our Country, and have Great Policies and Ideas. These American Patriots are being absolutely “blurred out” by the Media, and Fox is doing little to help. That’s the only reason this Race is close, if it is indeed close. President DONALD J. TRUMP</p>",
"account": {
"id": "107780257626128497",
"username": "realDonaldTrump",
"acct": "realDonaldTrump",
"display_name": "Donald J. Trump",
"locked": false,
"bot": false,
"discoverable": false,
"group": false,
"created_at": "2022-02-11T16:16:57.705Z",
"note": "<p></p>",
"url": "https://truthsocial.com/@realDonaldTrump",
"avatar": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg",
"avatar_static": "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",
"header_static": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg",
"followers_count": 13132450,
"following_count": 69,
"statuses_count": 37558,
"last_status_at": "2026-10-25",
"verified": true,
"location": "",
"website": "www.DonaldJTrump.com",
"unauth_visibility": true,
"chats_onboarded": true,
"feeds_onboarded": true,
"accepting_messages": false,
"show_nonmember_group_statuses": false,
"emojis": [],
"fields": [],
"tv_onboarded": false,
"tv_account": false,
"premium": true
},
"media_attachments": [],
"mentions": [],
"tags": [],
"card": null,
"group": null,
"quote": null,
"in_reply_to": null,
"reblog": null,
"sponsored": false,
"replies_count": 544,
"reblogs_count": 619,
"favourites_count": 1876,
"reaction": null,
"upvotes_count": 1876,
"downvotes_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"pinned": false,
"bookmarked": false,
"poll": null,
"emojis": [],
"votable": false,
"edited_at": null,
"version": "1",
"editable": true,
"title": null,
"embedded_announcement": null,
"signature": "WyJhbm9uOjIwYzY1NzBkLTk0MjAtNGZjOS05OTZlLTZmYTc1ZjM5Yzg3YiIsMTE3NTAyNTcyODI4MjI1MzI0LDE3OTI5NDgxMTBd.K0SDVrJKWdF7DBidLYV_2A"
},
{
"text": "https://www.youtube.com/live/tVCs0-N4XiY?si=qvAuIZc2WDP8MCEL",
"id": "117502341995120080",
"created_at": "2026-10-25T15:50:50.854Z",
"in_reply_to_id": null,
"quote_id": null,
"in_reply_to_account_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "https://truthsocial.com/@realDonaldTrump/117502341995120080",
"url": "https://truthsocial.com/@realDonaldTrump/117502341995120080",
"content": "<p><a href=\"https://www.youtube.com/live/tVCs0-N4XiY?si=qvAuIZc2WDP8MCEL\" rel=\"nofollow noopener noreferrer\" target=\"_blank\"><span class=\"invisible\">https://www.</span><span class=\"ellipsis\">youtube.com/live/tVCs0-N4XiY?s</span><span class=\"invisible\">i=qvAuIZc2WDP8MCEL</span></a></p>",
"account": {
"id": "107780257626128497",
"username": "realDonaldTrump",
"acct": "realDonaldTrump",
"display_name": "Donald J. Trump",
"locked": false,
"bot": false,
"discoverable": false,
"group": false,
"created_at": "2022-02-11T16:16:57.705Z",
"note": "<p></p>",
"url": "https://truthsocial.com/@realDonaldTrump",
"avatar": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg",
"avatar_static": "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",
"header_static": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg",
"followers_count": 13132450,
"following_count": 69,
"statuses_count": 37558,
"last_status_at": "2026-10-25",
"verified": true,
"location": "",
"website": "www.DonaldJTrump.com",
"unauth_visibility": true,
"chats_onboarded": true,
"feeds_onboarded": true,
"accepting_messages": false,
"show_nonmember_group_statuses": false,
"emojis": [],
"fields": [],
"tv_onboarded": false,
"tv_account": false,
"premium": true
},
"media_attachments": [],
"mentions": [],
"tags": [],
"card": {
"id": null,
"url": "https://www.youtube.com/live/tVCs0-N4XiY?si=qvAuIZc2WDP8MCEL",
"title": "LIVE: President Trump Holds a Rally in Port Huron, MI - 10/25/26",
"description": "Watch RSBN LIVE for full coverage of President Trump, pre-program speakers, and exclusive crowd interviews. Subscribe on Rumble: https://rumble.com/c/RSBNTu...",
"type": "video",
"author_name": "",
"author_url": "",
"provider_name": "www.youtube.com",
"provider_url": "",
"html": "<iframe src=\"https://www.youtube.com/embed/tVCs0-N4XiY\" width=\"640\" height=\"360\" allowtransparency=\"true\" scrolling=\"no\" frameborder=\"0\"></iframe>",
"width": 640,
"height": 360,
"image": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/cache/preview_cards/images/078/350/744/original/b10b2a02e7bd8213.jpg",
"embed_url": "",
"blurhash": "USIgm02wxxO@+]S~MxoJI:RjxuoLV[WXkqj[",
"links": null,
"group": null
},
"group": null,
"quote": null,
"in_reply_to": null,
"reblog": null,
"sponsored": false,
"replies_count": 280,
"reblogs_count": 730,
"favourites_count": 2411,
"reaction": null,
"upvotes_count": 2411,
"downvotes_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"pinned": false,
"bookmarked": false,
"poll": null,
"emojis": [],
"votable": false,
"edited_at": null,
"version": "1",
"editable": true,
"title": null,
"embedded_announcement": null,
"signature": "WyJhbm9uOjIwYzY1NzBkLTk0MjAtNGZjOS05OTZlLTZmYTc1ZjM5Yzg3YiIsMTE3NTAyMzQxOTk1MTIwMDgwLDE3OTI5NDgxMTBd.O-pCViZVNZyAS3NYmCOc5g"
}
],
"next_max_id": "117496229811089720"
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
Posts come in `posts`, 20 per page, replies excluded. Pass `next_max_id` from the answer back as `next_max_id` for the next page; it is null on the last page. An account without public posts returns an empty list for 0 credits. An unknown account is a free 404. Truth Social shows most accounts only to signed-in users; prominent public accounts work, others may return a free 403.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.