# Truth Social Profile Posts Scraper (`scraper-engine/truth-social-profile-posts-scraper`) Actor ๐Ÿ“ฃ Truth Social Profile Posts Scraper extracts public profile posts: text, timestamps, links, hashtags, mentions & engagement. ๐Ÿ”Ž Ideal for social listening, competitor monitoring, and analytics. ๐Ÿš€ Fast, reliable Truth Social scraper for research & marketing. ๐Ÿ“Š - **URL**: https://apify.com/scraper-engine/truth-social-profile-posts-scraper.md - **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community) - **Categories:** Social media, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Truth Social Profile Posts Scraper Truth Social Profile Posts Scraper extracts public posts from Truth Social profiles into structured, analysis-ready datasets โ€” fast, reliable, and built for scale. It solves the manual hassle of scrolling and copy-paste by automating the capture of posts (text, timestamps, links, hashtags, mentions, media refs) from any public profile. Designed for marketers, developers, data analysts, and researchers, this Truth Social profile posts extractor doubles as a Truth Social user timeline scraper and Truth Social profile content scraper for social listening, competitor monitoring, and insights at scale. ### What data / output can you get? Each dataset item is one post saved as a full status object (streamed live as itโ€™s fetched). Fields are normalized to a Mastodon-shaped output with template keys merged for consistency. | Data type | Description | Example value | | --- | --- | --- | | id | Unique post ID (string) | "113813511870104000" | | created_at | ISO timestamp of the post | "2026-04-19T12:12:34.000Z" | | url | Canonical URL to the post | "https://truthsocial.com/@example/posts/113813511870104000" | | content | Post body (HTML) | "

Great news today! ๐ŸŽ‰

" | | account | Author object (includes merged fields) | { "id": "12345", "display_name": "Example", "location": "" } | | in_reply_to_id | Parent post ID if itโ€™s a reply | null | | quote_id | Quoted post ID if present | null | | in_reply_to_account_id | Parent author ID if a reply | null | | media_attachments | Array of media attachment objects | [] | | mentions | Array of mention objects | [] | | tags | Array of tag objects (hashtags) | [] | | card | Link preview card (if present) | null | | quote | Embedded quoted status object (if enrichment is on) | null | | in_reply_to | Embedded parent status object (if enrichment is on) | null | | reblog | Reblog/boost object if applicable | null | | reaction | Reaction data if present | null | | poll | Poll data if present | null | | emojis | Custom emoji metadata | [] | | edited_at | Last edit timestamp if edited | null | | title | Post title if present | null | Notes: - Output is shaped like the Truth Social API v1 status with additional template keys guaranteed (even if empty) for stable parsing. - The account object is merged with defaults for consistency: it always contains location, emojis, and fields keys. - Export your dataset to CSV, JSON, or Excel from the Apify platform to feed BI tools or pipelines (e.g., Truth Social posts to CSV or export Truth Social posts to JSON). ### Key features - โšก Fast, resilient extraction Uses batched requests (up to 40 per page) with robust retry logic to reliably collect posts even when the site is busy. - ๐Ÿง  Quote/reply enrichment (optional, on by default) Automatically expands quote and reply relationships by fetching the referenced posts and embedding them into quote and in_reply_to fields for richer context. - ๐Ÿ“ฆ Streamed results to dataset Posts are pushed live as rows, so you can watch the Truth Social profile feed crawler working in real time and download partial results anytime. - ๐Ÿ“Š Flexible volume control Limit by maxItems per profile (1โ€“10,000) or pull all available posts using advanced JSON input. Ideal for a Truth Social profile archiver or Truth Social posts downloader. - ๐Ÿ” Residential proxy built-in Always uses Apify RESIDENTIAL proxies for reliable access. Proxy credentials are configurable via proxyConfiguration. - ๐Ÿง‘โ€๐Ÿ’ป Developer-friendly Built on Apify (Python). Integrate with the Apify API, connect to your Truth Social posts scraper Python workflows, or automate exports to analytics stacks. - ๐Ÿ” Automation-ready Schedule runs on Apify to power a Truth Social account posts monitor and export data continuously to CSV/JSON for downstream systems. - ๐Ÿ—๏ธ Production-grade reliability Robust retry strategy (including per-page and per-request caps) ensures stability for high-volume Truth Social posts scraper use cases. ### How to use Truth Social Profile Posts Scraper - step by step 1. Create or log in to your Apify account. 2. Open the Truth Social Profile Posts Scraper actor. 3. In Input, add one or more usernames in the username list (handles like realDonaldTrump โ€” โ€œ@โ€ optional). 4. Set maxItems to control how many posts you collect per profile (default 20; up to 10,000). 5. (Optional) Set firstPostId and/or lastPostId to page deeper into a specific slice of older posts. 6. (Recommended) Configure proxyConfiguration (the actor always uses the RESIDENTIAL group; your settings determine credentials/account). 7. Click Start. Posts will stream into the dataset as theyโ€™re saved. Watch progress in the logs and Output tab. 8. Download results from the Dataset as CSV, JSON, or Excel for analysis, dashboards, or pipelines. Pro Tip: Advanced JSON users can fine-tune behavior with enrichRelations and requestDelaySeconds, or use legacy maximumPosts/urls compatibility for older tasks when you need to scrape Truth Social user posts at scale. ### Use cases | Use case name | Description | | --- | --- | | Social listening for marketing | Track public narratives and campaign impact by capturing user timelines and exporting Truth Social posts to JSON or CSV. | | Competitor monitoring | Monitor competitor profiles and analyze post cadence, engagement signals, and link shares over time. | | Academic & policy research | Build longitudinal datasets of public statements and hashtags using this Truth Social data scraper tool. | | Brand safety & risk analysis | Archive profile posts for audit trails, compliance checks, and sentiment tracking with a Truth Social profile posts export. | | Media & journalism workflows | Quickly retrieve quotes and threads (with context enrichment) for reporting and fact-checking. | | Data engineering pipelines | Automate a Truth Social user posts API scraping workflow via Apify API for ingestion into warehouses and BI tools. | | Archiving & collections | Operate a Truth Social profile archiver to snapshot public timelines for future reference or analysis. | ### Why choose Truth Social Profile Posts Scraper? Built for precision, automation, and reliability, this scraper delivers consistent, structured outputs for modern data workflows. - โœ… Accurate, structured output โ€” normalized Mastodon-shaped status objects with stable template keys - ๐ŸŒ Residential proxy reliability โ€” always routes via Apify RESIDENTIAL for consistent access - ๐Ÿ“ˆ Scales to thousands of posts โ€” maxItems up to 10,000 with batched pagination - ๐Ÿงฉ Developer access โ€” integrate via Apify API into Python/ETL pipelines - ๐Ÿ”’ Public data only โ€” designed for publicly accessible profile posts - ๐Ÿ’ธ Efficient operations โ€” stream results live, export in the formats you need - ๐Ÿ”ง Better than browser extensions โ€” resilient retries, server-side execution, and dataset exports beat unstable point-and-click tools In short, itโ€™s a production-ready Truth Social profile content scraper that handles the heavy lifting so your team can focus on insights. ### Is it legal / ethical to use Truth Social Profile Posts Scraper? Yesโ€”when done responsibly. This actor targets publicly available Truth Social profile posts and does not access private or authenticated data. Guidelines: - Collect only public content and respect platform terms. - Ensure compliance with data protection laws (e.g., GDPR, CCPA) relevant to your use. - Avoid scraping or using private/personal data for spam or misuse. - Consult your legal team for edge cases or special jurisdictions. ### Input parameters & output format Example JSON input (UI schema fields): ```json { "username": ["realDonaldTrump", "exampleUser"], "maxItems": 50, "firstPostId": "113813511870104000", "lastPostId": "", "proxyConfiguration": { "useApifyProxy": true } } ```` Advanced JSON overrides (optional): ```json { "enrichRelations": true, "requestDelaySeconds": 1, "maximumPosts": 0, "urls": [ "https://truthsocial.com/@realDonaldTrump", { "url": "https://truthsocial.com/@exampleUser" } ] } ``` Parameter reference: - username (array of string) โ€” Add one or more handles (e.g., "realDonaldTrump"). Required: Yes. Default: none. Notes: โ€œ@โ€ optional; minItems: 1. - maxItems (integer) โ€” Cap the number of posts per profile. Required: No. Default: 20. Range: 1โ€“10,000. - firstPostId (string) โ€” Start older than this post ID (optional). Required: No. Default: none. - lastPostId (string) โ€” Stop at or below this post ID (optional). Required: No. Default: none. - proxyConfiguration (object) โ€” Apify proxy credentials/settings. Required: No. Default prefill: {"useApifyProxy": true}. Note: The actor always uses the RESIDENTIAL group. Notes: - Advanced JSON-only keys enrichRelations and requestDelaySeconds are supported by the underlying code. Legacy keys maximumPosts (0 = unlimited) and urls array are also supported for backward compatibility. Example JSON output (one item): ```json { "id": "113813511870104000", "created_at": "2026-04-19T12:12:34.000Z", "url": "https://truthsocial.com/@exampleUser/posts/113813511870104000", "content": "

Great news today! ๐ŸŽ‰

", "in_reply_to_id": null, "quote_id": null, "in_reply_to_account_id": null, "media_attachments": [], "mentions": [], "tags": [], "card": null, "group": null, "quote": null, "in_reply_to": null, "reblog": null, "reaction": null, "poll": null, "emojis": [], "edited_at": null, "title": null, "account": { "id": "987654321", "display_name": "Example User", "username": "exampleUser", "location": "", "emojis": [], "fields": [] } } ``` Which fields may be empty? - Many enrichment/template fields (e.g., quote, in\_reply\_to, media\_attachments, poll, edited\_at) may be null or empty arrays when not present on the post. ### FAQ #### Do I need to log in to scrape posts? No. The scraper targets publicly available profile posts and does not require login or session cookies. #### Is a proxy required? Yes. The actor always uses Apify RESIDENTIAL proxies. You can supply proxyConfiguration credentials in the input; the proxy group is enforced to RESIDENTIAL for reliability. #### How many posts can I scrape per run? You can set maxItems up to 10,000 per profile via the input schema. Advanced JSON mode also supports a legacy maximumPosts field, where 0 means โ€œunlimitedโ€ until posts run out. #### What data types are included in the output? Each dataset item is a full status object with keys like id, created\_at, url, content, account, tags, mentions, media\_attachments, plus normalized fields such as quote and in\_reply\_to for context. #### Can I export results to CSV or JSON? Yes. Open the Dataset for your run on Apify and export to CSV, JSON, or Excel. This makes it easy to move Truth Social posts to CSV or export Truth Social posts to JSON for downstream use. #### Does it enrich quotes and replies? Yes. By default, the scraper attempts to fetch and embed quoted and parent posts into quote and in\_reply\_to fields. You can control this via the advanced JSON key enrichRelations. #### Can I use this with Python or an API? Yes. Access your dataset via the Apify API to integrate the Truth Social posts scraper Python-side or plug it into ETL and analytics workflows. #### Can I monitor accounts over time? Yes. Schedule the actor on Apify to run periodically and capture new posts from target profiles, enabling a Truth Social account posts monitor workflow. ### Closing CTA / Final thoughts Truth Social Profile Posts Scraper is built to collect public profile posts accurately and at scale. With normalized outputs, optional quote/reply enrichment, and residential proxy reliability, itโ€™s ideal for marketers, developers, analysts, and researchers. Integrate via the Apify API, export to CSV/JSON/Excel, and automate end-to-end pipelines with ease. Start extracting smarter Truth Social insights today. # Actor input Schema ## `username` (type: `array`): ๐Ÿ’ฌ Add one or more **handles** (example: *realDonaldTrump*). You can skip the **@** โ€” weโ€™ll figure it out! ## `maxItems` (type: `integer`): ๐Ÿงฎ Cap the number of posts we save for you (pick what fits your project). ## `firstPostId` (type: `string`): ๐Ÿช„ *Optional.* Paste a post **ID** only if you want to page **deeper** into older posts. Most runs leave this blank! ## `lastPostId` (type: `string`): ๐Ÿช„ *Optional.* Stop when we reach posts at or **below** this ID. Leave empty to keep going until your cap. ## `proxyConfiguration` (type: `object`): ๐Ÿ” Optional. This actor **always** uses the **RESIDENTIAL** proxy group; your selection here only affects credentials / Apify account settings, not the proxy type. ## Actor input object example ```json { "username": [ "realDonaldTrump" ], "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "username": [ "realDonaldTrump" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("scraper-engine/truth-social-profile-posts-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "username": ["realDonaldTrump"], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("scraper-engine/truth-social-profile-posts-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "username": [ "realDonaldTrump" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call scraper-engine/truth-social-profile-posts-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraper-engine/truth-social-profile-posts-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Truth Social Profile Posts Scraper", "description": "๐Ÿ“ฃ Truth Social Profile Posts Scraper extracts public profile posts: text, timestamps, links, hashtags, mentions & engagement. ๐Ÿ”Ž Ideal for social listening, competitor monitoring, and analytics. ๐Ÿš€ Fast, reliable Truth Social scraper for research & marketing. ๐Ÿ“Š", "version": "1.0", "x-build-id": "zvtFF1k1wSxlVBug6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~truth-social-profile-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-truth-social-profile-posts-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scraper-engine~truth-social-profile-posts-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-truth-social-profile-posts-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scraper-engine~truth-social-profile-posts-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-truth-social-profile-posts-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "username" ], "properties": { "username": { "title": "๐Ÿ”Žโœจ Which profile?", "minItems": 1, "type": "array", "description": "๐Ÿ’ฌ Add one or more **handles** (example: *realDonaldTrump*). You can skip the **@** โ€” weโ€™ll figure it out!", "items": { "type": "string" } }, "maxItems": { "title": "๐Ÿ“Š How many posts?", "minimum": 1, "maximum": 10000, "type": "integer", "description": "๐Ÿงฎ Cap the number of posts we save for you (pick what fits your project).", "default": 20 }, "firstPostId": { "title": "โฎ๏ธ Start older than this post", "type": "string", "description": "๐Ÿช„ *Optional.* Paste a post **ID** only if you want to page **deeper** into older posts. Most runs leave this blank!" }, "lastPostId": { "title": "โน๏ธ Stop at this post", "type": "string", "description": "๐Ÿช„ *Optional.* Stop when we reach posts at or **below** this ID. Leave empty to keep going until your cap." }, "proxyConfiguration": { "title": "๐ŸŒ Apify proxy (account / password)", "type": "object", "description": "๐Ÿ” Optional. This actor **always** uses the **RESIDENTIAL** proxy group; your selection here only affects credentials / Apify account settings, not the proxy type." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```