Artemis I: humanity's return to the Moon begins.
", "createdAt": "2026-09-30T13:04:11.000Z", "likes": 4521, "replies": 132, "reblogs": 887, "mediaCount": 1, "mediaUrls": "https://media.truthsocial.com/media_attachments/files/.../original.jpeg", "mediaTypes": "image", "inReplyToId": null, "spoilerText": null, "isReblog": false, "rebloggedFrom": null } ``` ### How to use **Option A — scrape a list of accounts:** 1. Create a new run of the actor. 2. In **Account handles**, enter one or more handles without the @, e.g. `realDonaldTrump`, `nasa`. 3. Set **Max posts per account** (default 1000) and **Max results** (default 10,000). 4. Leave the proxy configuration as it is — the scraper chooses US residential exits on its own. 5. Click **Start**; when the run finishes, open the dataset to preview and export. ```json { "handles": ["realDonaldTrump", "nasa", "FoxNews"], "maxPostsPerUser": 200, "maxResults": 500, "proxyConfiguration": { "useApifyProxy": true } } ``` **Option B — deep archive of one account:** 1. Enter a single handle. 2. Raise **Max posts per account** to 1000+ to walk far back in the timeline. 3. The actor stops automatically at the end of the accessible timeline. ```json { "handles": ["realDonaldTrump"], "maxPostsPerUser": 1000, "maxResults": 1000 } ``` ### Input parameters | Parameter | Type | Default | Description | |---|---|---|---| | handles | array of strings | `["realDonaldTrump", "nasa", "FoxNews"]` | Account handles without @; each is paginated separately | | maxPostsPerUser | integer | 1000 | Maximum posts fetched per account, newest first | | maxResults | integer | 10000 | Global cap on total posts pushed across all accounts | | proxyConfiguration | proxy | automatic (US residential first) | Optional; your own proxy URLs/groups are tried first | Full input JSON: ```json { "handles": ["realDonaldTrump", "nasa", "FoxNews"], "maxPostsPerUser": 1000, "maxResults": 10000, "proxyConfiguration": { "useApifyProxy": true } } ``` ### Output example One fully-populated dataset item: ```json { "handle": "FoxNews", "accountId": "107891234567890123", "username": "FoxNews", "displayName": "Fox News", "followersCount": 231456, "followingCount": 12, "statusesCount": 45678, "accountUrl": "https://truthsocial.com/@FoxNews", "accountCreatedAt": "2022-04-01T00:00:00.000Z", "noteText": "Follow Fox News for breaking news and stories.", "avatarUrl": "https://media.truthsocial.com/accounts/avatars/.../foxnews.png", "postId": "109712345678901234", "postUrl": "https://truthsocial.com/@FoxNews/109712345678901234", "contentText": "BREAKING: …", "contentHtml": "", "createdAt": "2026-10-01T09:15:44.000Z", "likes": 987, "replies": 45, "reblogs": 210, "mediaCount": 0, "mediaUrls": null, "mediaTypes": null, "inReplyToId": null, "spoilerText": null, "isReblog": true, "rebloggedFrom": "SomeOriginalAccount" } ``` ### Tips for best results - Handles are case-insensitive on lookup, but use the exact casing shown on the profile for safest results. - The lookup runs once per handle; a 404 handle is skipped with a warning and the run continues with the rest. - Posts are returned newest-first — the first rows in your dataset are the most recent. - Engagement counters are point-in-time values captured during the run. - Reblogs contain the original post's content; use `isReblog`/`rebloggedFrom` to filter them out for original-content analysis. - `contentHtml` preserves links and mentions; use it when you need URLs mentioned in a post. - Very large timelines may need multiple runs with `maxPostsPerUser` adjusted; Truth Social paginates in 40-post pages. - Schedule daily runs to build a longitudinal archive of account activity. - Combine with a sentiment-analysis or LLM actor to classify post content at scale. - Export to Excel or Google Sheets for quick sharing with non-technical stakeholders. ### Integrations - **Google Sheets** — stream results into a sheet with the Apify Sheets integration. - **Slack** — post digests of new runs to a channel. - **Zapier / Make** — automate downstream workflows (Airtable, CRM, email digests). - **Webhooks** — receive an HTTP callback when a run completes. - **Schedules** — run daily or hourly for continuous monitoring. - **API & MCP** — call the actor from any backend or AI agent (see below). ### API usage cURL: ```bash curl -X POST "https://api.apify.com/v2/acts/logiover~truth-social-posts-scraper/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"handles":["nasa"],"maxPostsPerUser":100}' ``` Node.js (Apify client): ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('logiover~truth-social-posts-scraper').call({ handles: ['realDonaldTrump', 'nasa'], maxPostsPerUser: 500, maxResults: 1000, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} posts`); ``` Python: ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("logiover~truth-social-posts-scraper").call(run_input={ "handles": ["nasa"], "maxPostsPerUser": 100, }) items = client.dataset(run["defaultDatasetId"]).list_items().items print(f"Got {len(items)} posts") ``` ### Use with AI agents (MCP) The actor works with Apify's Model Context Protocol (MCP) server, so Claude, Cursor, or any MCP-capable agent can trigger runs and read the dataset directly. Example prompt: *"Use the truth-social-posts-scraper actor for handles \['nasa'] with maxPostsPerUser 200, then summarize the five most-liked posts and the account's average engagement rate."* ### FAQ #### Do I need a Truth Social account or API key? No. The actor uses Truth Social's public, Mastodon-compatible API endpoints through Apify's proxy. No login, no token. #### Which accounts can I scrape? Any public account. Private, suspended or non-existent handles return a 404 on lookup and are skipped with a warning. #### How many posts can I get in one run? Up to `maxPostsPerUser` per account (default 1,000) and `maxResults` in total (default 10,000). The timeline is walked in 40-post pages, newest first. #### Why did an account return fewer posts than its status count? Truth Social's public timeline API only exposes a window of a account's history; once the cursor stops advancing, the actor stops. Deleted posts and some reply threads may also be excluded by the server. #### What is the difference between contentText and contentHtml? `contentText` is the readable plain text (tags stripped, entities decoded); `contentHtml` is the raw HTML with links, mentions and hashtags preserved. #### Are reblogs included? Yes. Reblog rows carry the original post's content and engagement plus `isReblog: true` and `rebloggedFrom` so you can filter them. #### What formats can I export to? CSV, JSON, JSONL, Excel (XLSX), and XML — from the dataset tab, via API, or through integrations. #### How fast is a run? Each 40-post page takes roughly a second under polite pacing; 1,000 posts per account typically finish in well under a minute. #### Is it legal to scrape Truth Social posts? The actor only reads publicly visible posts from public accounts. You should still respect Truth Social's Terms of Use and applicable privacy laws (GDPR/CCPA) when storing or processing personal data, and use the data for legitimate research. This tool is not affiliated with, endorsed by, or sponsored by Trump Media & Technology Group or Truth Social. #### How often is the data updated? Every run queries Truth Social live. Schedule recurring runs for continuous freshness. #### Can I get likes for historical snapshots? No. Engagement counters reflect the moment of the run. Schedule repeated runs to track growth over time. #### Does the actor follow threads and conversations? It records `inReplyToId` for replies found in an account's timeline, but it does not crawl full conversation trees. ### Is it legal? Truth Social Posts Scraper extracts only publicly accessible posts from public accounts, without login or bypass of access controls. You are responsible for complying with Truth Social's Terms of Use and privacy regulations (GDPR, CCPA) when using the output, especially since posts may contain personal data. The actor and its author are not affiliated with, endorsed by, or sponsored by Trump Media & Technology Group. "Truth Social" and related marks are trademarks of Trump Media & Technology Group Corp. ### Related scrapers - **X (Twitter) Post Scrapers** (logiover) — cross-platform comparison of the same accounts. - **GETTR / Gab / Parler-style scrapers** — alternative social networks for comparative research. - **Reddit Archive Scraper** (logiover) — long-history social discussions. - **RSS & News Feed Scrapers** (logiover) — pair social posts with news coverage. # Changelog This Actor's version history is a separate document: https://apify.com/logiover/truth-social-posts-scraper/changelog.md # Actor input Schema ## `handles` (type: `array`): List of Truth Social account handles without the @ (e.g. 'realDonaldTrump', 'nasa'). Each account is scraped separately with cursor pagination. ## `maxPostsPerUser` (type: `integer`): Maximum number of posts to fetch per account (newest first). Accounts with fewer posts stop at the end of their timeline automatically. ## `maxResults` (type: `integer`): Global cap on total posts pushed to the dataset across all accounts. Once reached, the run finishes gracefully. ## `proxyConfiguration` (type: `object`): Optional. Leave as is: the scraper picks its own exits — US residential IPs first, then other residential and datacenter IPs — because Truth Social's Cloudflare refuses most datacenter and all proxy-less requests. Residential traffic is included in the price per result. If you set your own proxy URLs or groups here, they are tried first. ## Actor input object example ```json { "handles": [ "realDonaldTrump", "FoxNews", "newsmax" ], "maxPostsPerUser": 1000, "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `handle` (type: `string`): No description ## `username` (type: `string`): No description ## `displayName` (type: `string`): No description ## `followersCount` (type: `string`): No description ## `followingCount` (type: `string`): No description ## `statusesCount` (type: `string`): No description ## `accountUrl` (type: `string`): No description ## `accountCreatedAt` (type: `string`): No description ## `noteText` (type: `string`): No description ## `avatarUrl` (type: `string`): No description ## `postId` (type: `string`): No description ## `postUrl` (type: `string`): No description ## `contentText` (type: `string`): No description ## `contentHtml` (type: `string`): No description ## `createdAt` (type: `string`): No description ## `likes` (type: `string`): No description ## `replies` (type: `string`): No description ## `reblogs` (type: `string`): No description ## `mediaCount` (type: `string`): No description ## `mediaUrls` (type: `string`): No description ## `mediaTypes` (type: `string`): No description ## `inReplyToId` (type: `string`): No description ## `spoilerText` (type: `string`): No description ## `isReblog` (type: `string`): No description ## `rebloggedFrom` (type: `string`): No description ## `accountId` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '