Developer tutorial
How to scrape Truth Social posts with Python (2026)
This tutorial shows how to scrape Truth Social posts in Python using the SocialCrawl API. You get a user's posts with text, media, timestamp, and reply, repost, and like counts, paginated by cursor from one GET request, with no Truth Social developer account, proxies, or HTML parsing. The code below is runnable as-is, and the response underneath it is a real, unedited call.
Code tested July 2026
How it works
- 1Get a free API keyCreate a SocialCrawl account and copy your API key from the dashboard. Every new account starts with free credits.
- 2Set up PythonInstall the requests library with `pip install requests`.
- 3Call the Truth Social User Posts endpointSend a GET request to /v1/truthsocial/user/posts with your API key in the x-api-key header and the `handle` parameter.
- 4Read the responseParse the JSON. SocialCrawl returns a user's posts with text, media, timestamp, and reply, repost, and like counts, paginated by cursor in one normalized schema, so you write no HTML parsing or proxy code.
The code
A real, unedited response from the request above.
import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/truthsocial/user/posts",
headers={"x-api-key": "YOUR_API_KEY"},
params={"handle": "realDonaldTrump"},
)
data = response.json()
print(data)[ RESPONSE ]
{
"success": true,
"platform": "truthsocial",
"endpoint": "/v1/truthsocial/user/posts",
"data": {
"items": [
{
"post": {
"id": "116949510224898590",
"url": "https://truthsocial.com/@realDonaldTrump/116949510224898590",
"content": {
"text": "Christopher Maccio, the Great Opera Singer, was AMAZING at the World Cup today — He \"took the house down!\" President DONALD J. TRUMP",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": "realDonaldTrump",
"display_name": "Donald J. Trump",
"avatar_url": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg",
"verified": true
},
"engagement": {
"views": null,
"likes": 187,
"comments": 7,
"shares": 47,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-07-20T00:38:27.481Z"
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
}
},
{
"post": {
"id": "116949495681903940",
"url": "https://truthsocial.com/@realDonaldTrump/116949495681903940",
"content": {
"text": "Wonderful news! I have just been informed that Giant Eagle, a GREAT American Grocery Company, will be lowering Prices, by a lot, across more than 300 products this Summer, through Labor Day, to help hardworking American families. Giant Eagle, like Walmart, is stepping up in a big and bold way to answer my call to lower costs for working families. We will continue to bring Prices DOWN, just like Oil, Gas, Eggs, and Prescription Drugs, all of which are dropping FAST after the disaster we inherited from Sleepy Joe Biden. Other Grocery Chains must immediately follow the lead of these absolute Patriots at Giant Eagle and Walmart. Together, we will make America stronger and more affordable than ever before, and get rid of the stench and Inflation perpetrated on us by the Dumocrats and the Sleepy Joe Biden Administration! President DONALD J. TRUMP",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": "realDonaldTrump",
"display_name": "Donald J. Trump",
"avatar_url": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg",
"verified": true
},
"engagement": {
"views": null,
"likes": 758,
"comments": 78,
"shares": 212,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-07-20T00:34:45.576Z"
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
}
}
],
"next_cursor": "116948000486397370",
"total": null,
"dropped": 0
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoiMTE2OTQ4MDAwNDg2Mzk3MzcwIiwicCI6Im5leHRfbWF4X2lkIn0",
"has_more": true,
"page_size": 20
}
}Prefer another language?
FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usDo I need a Truth Social developer account to scrape Truth Social posts?
No. SocialCrawl handles authentication and proxies upstream, so you never register a Truth Social app, manage OAuth tokens, or run your own scrapers. One API key returns Truth Social data directly.
What does the Truth Social User Posts endpoint return?
It returns a user's posts with text, media, timestamp, and reply, repost, and like counts, paginated by cursor. The response is normalized into SocialCrawl's unified schema, identical in shape across every platform.
How much does it cost to scrape Truth Social posts?
Each call costs a small number of credits, and new accounts start with free credits. There are no monthly minimums, so you pay only for the calls you make.
Can I use this Python code in production?
Yes. The snippet on this page is the real request against the live API. For production, add error handling and follow the response cursor to paginate through large result sets.
Ask AI about SocialCrawl