# Truth Social Posts Scraper (`neuro-scraper/truth-social-posts-scraper`) Actor

Truth Social Posts Scraper SD - Truth Social Posts Scraper is a logged-out tool that extracts posts (Truths), replies and ReTruths from public Truth Social profiles: text, date, likes, ReTruths, replies, media, links, hashtags, mentions, quotes and author profile data, with full-history paging.

- **URL**: https://apify.com/neuro-scraper/truth-social-posts-scraper.md
- **Developed by:** [Neuro Scraper](https://apify.com/neuro-scraper) (community)
- **Categories:** Social media, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.19 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Truth Social Posts Scraper

The Truth Social Posts Scraper collects public Truth social posts and returns it as a clean dataset you can download as JSON, CSV or Excel, or read through the Apify API. No login, no cookies and no code: give the Truth Social Posts Scraper your input, start it and get structured Truth data for research, monitoring, analytics or lead generation. You pay only for the results you receive.

> ⭐ **Featured by Neuro Scraper: [Facebook Reels Scraper](https://apify.com/neuro-scraper/facebook-reels-scraper)** - scrape Facebook Reels from any page, profile or reel link with exact views and plays, every reaction type (Like, Love, Care, Haha, Wow, Sad, Angry), comments, shares, captions, music and video links. No login and no cookies. [Try the Facebook Reels Scraper →](https://apify.com/neuro-scraper/facebook-reels-scraper)

./README.md

### Input

Every option of the Truth Social Posts Scraper, as it appears in the input form and the API:

| Field | Type | Default | What it does |
|---|---|---|---|
| `usernames` | array | `["realDonaldTrump"]` | Truth Social profiles, one per line: a username (realDonaldTrump), @handle (@JackPosobiec) or profile URL (https://truthsocial.com/@realDonaldTrump). Only profiles Truth Social shows to logged-out visitors return posts;  |
| `postUrls` | array | `[]` | Optional. Specific posts to fetch, one per line: a post URL (https://truthsocial.com/@realDonaldTrump/posts/117408959105269388) or a bare post ID. One row per post. |
| `mode` | string | `"posts"` | posts = the profile's posts and ReTruths (replies left out by the server); posts_and_replies = everything the profile wrote; replies = only its replies; profile = one profile-details row per profile (followers, posts cou |
| `maxPosts` | integer | `20` | How many posts to save for each profile. Pages of 20 (the server's fixed page size) are followed with Truth Social's own max_id cursor until this number, the date limit or the profile's first post. 0 = the whole history. |
| `onlyMedia` | boolean | `false` | Keep only posts with images or videos (Truth Social's own only_media filter). |
| `includeReblogs` | boolean | `true` | Keep ReTruths of other people's posts. Turned off, they are dropped as pages are read (the server ignores its exclude_reblogs parameter - measured), so Max posts counts own posts only. |
| `postsNewerThan` | string | `""` | Optional. Keep only posts published on or after this date (YYYY-MM-DD or ISO date-time), or a relative age such as '7 days' / '12 hours'. Posts come newest first, so paging stops at the first older post. |
| `startFromId` | string | `""` | Optional. Start below this post ID (or post URL): only posts older than it are returned. Useful to continue a long history in several runs. |
| `continueFromLastPostId` | boolean | `false` | Monitoring mode: remember the newest post ID per profile in the named key-value store 'truth-social-posts-state' and, on the next run, stop at that post - only new posts are saved. |
| `peek` | boolean | `false` | With 'Only new posts since the last run': return the new posts but leave the saved post ID where it is, so the next normal run still returns them (a quick 'anything new?' check). |
| `cleanContent` | boolean | `true` | content as plain text (paragraphs kept as line breaks). Turned off, content keeps Truth Social's HTML. contentHtml always has the HTML. |
| `proxyConfiguration` | object | `{"useApifyProxy": true, "apifyProxyGroup` | Apify residential proxies in the United States are the default and recommended (the API sits behind Cloudflare). |

### Output fields

Each Truth Social Posts Scraper row is one JSON object with these fields (CSV and Excel exports use the same columns):

- `type`
- `id`
- `url`
- `createdAt`
- `content`
- `contentHtml`
- `language`
- `visibility`
- `repliesCount`
- `reblogsCount`
- `favouritesCount`
- `upvotesCount`
- `downvotesCount`
- `hashtags`
- `mentions`
- `mediaAttachments`
- `mediaUrls`
- `mediaCount`
- `card`
- `poll`
- `inReplyToId`
- `inReplyToAccountId`
- `inReplyToUrl`
- `isReblog`
- `rebloggedFromUrl`
- `rebloggedFromUsername`
- `quoteId`
- `quote`
- `sponsored`
- `pinned`
- `editedAt`
- `authorId`
- `authorUsername`
- `authorDisplayName`
- `authorUrl`
- `authorAvatarUrl`
- `authorHeaderUrl`
- `authorBio`
- `authorWebsite`
- `authorLocation`
- `authorVerified`
- `authorFollowersCount`
- `authorFollowingCount`
- `authorPostsCount`
- `authorCreatedAt`
- `authorLastStatusAt`
- `input`
- `scrapedAt`

### Why use the Truth Social Posts Scraper

The Truth Social Posts Scraper is a Truth scraper and Truth data extractor for anyone who needs public Truth social posts as clean data. The Truth Social Posts Scraper handles web scraping, proxy rotation and retries for you, so you get a ready dataset instead of raw pages. Use the Truth Social Posts Scraper for market research, competitor analysis, lead generation, analytics or monitoring, and export the results to JSON, CSV, Excel or Google Sheets.

- No login and no code: the Truth Social Posts Scraper runs on Apify with one click or one API call.
- Pay per result: the Truth Social Posts Scraper charges only for rows delivered - no monthly Truth API fee.
- Complete fields: the Truth Social Posts Scraper returns every public field, with a stable schema for automation.
- Integrations: connect the Truth Social Posts Scraper to Zapier, Make, n8n, Google Sheets, a webhook or your CRM.

### Truth Social Posts Scraper use cases

- Market research: the Truth Social Posts Scraper collects Truth social posts at scale, so you can compare trends across weeks and niches.
- Competitor analysis: run the Truth Social Posts Scraper on a schedule and export the dataset to Google Sheets or Excel to watch what competitors publish.
- Lead generation and B2B prospecting: the Truth Social Posts Scraper gives a sales or agency team a clean list to load into a CRM.
- Content and social media monitoring: the Truth Social Posts Scraper keeps a fresh copy of Truth data through an Apify schedule and a webhook.
- Analytics and dashboards: send the Truth Social Posts Scraper output as JSON through the Apify API into Python, Node.js or a BI tool.
- Academic and data science projects: the Truth Social Posts Scraper returns a consistent schema, ready for pandas, R or a notebook.
- Price, product and brand tracking: the Truth Social Posts Scraper turns public Truth data into a dataset you can diff run by run.
- Automation workflows: connect the Truth Social Posts Scraper to Zapier, Make or n8n so every new row starts your next step.

### How to run it with the API, Python and Node.js

Start the Truth Social Posts Scraper from the Apify Console, or call it from code. The Truth Social Posts Scraper returns its dataset as JSON, CSV or Excel. With the Apify API you can run the Truth Social Posts Scraper from Python or Node.js, wait for it to finish and read the rows, which makes the Truth Social Posts Scraper easy to plug into an automation, a data pipeline or a scheduled export.

1. Open the Truth Social Posts Scraper on Apify and fill in the input (or send the same input as JSON to the API).
2. Start the Truth Social Posts Scraper. Follow the run log while the Truth Social Posts Scraper collects public Truth data.
3. Download the dataset as CSV, JSON, Excel or XLSX, or let a webhook send it on.
4. Schedule the Truth Social Posts Scraper to keep your Truth data fresh for monitoring and analytics.

### Tips for better results

- Start small: run the Truth Social Posts Scraper with a low maximum first, check the fields, then scale up the same input.
- Split big jobs: several smaller Truth Social Posts Scraper runs (by keyword, URL list or date) finish faster and are easier to resume.
- Keep a history: name a dataset or use a schedule so each Truth Social Posts Scraper run adds to your Truth data over time.
- Filter early: use the input filters of the Truth Social Posts Scraper so you only pay for the Truth social posts you really need.
- Automate the hand-off: a webhook or the Zapier and Make integrations can move every Truth Social Posts Scraper result straight to Google Sheets, a CRM or a database.
- Watch the run log: the Truth Social Posts Scraper writes what it is doing and why an item was skipped, so a surprising result is easy to explain.

### Truth Social Posts Scraper FAQ

#### Do I need a Truth account or login?

No. The Truth Social Posts Scraper works with no login and no cookies. It reads only public data, the same data any visitor can see.

#### Does it work with proxies?

Yes. The Truth Social Posts Scraper uses Apify Proxy by default and you can pick the proxy group or country in the input.

#### What happens if a run is interrupted?

The Truth Social Posts Scraper saves its progress, so a resurrected or restarted run continues where it stopped instead of paying for the same rows again.

#### What does this Truth scraper do?

The Truth Social Posts Scraper collects public Truth social posts and returns it as a structured dataset. It is web scraping without code: you set the input, start the Truth Social Posts Scraper and download JSON, CSV, Excel or XLSX.

#### Do you offer custom scrapers?

Yes. If you need a field or a filter the Truth Social Posts Scraper does not have yet, contact Neuro Scraper through the Apify Store page and we can extend the Truth Social Posts Scraper for you.

#### Can I export the results to Excel, CSV or Google Sheets?

Yes. Every Truth Social Posts Scraper run stores a dataset you can export as CSV, JSON, Excel (XLSX), XML or HTML, or send to Google Sheets with the Apify integration.

#### Can I use it through the API?

Yes. Start the Truth Social Posts Scraper and read its dataset through the Apify API from Python, Node.js or any HTTP client, or call it from Zapier, Make and n8n.

#### Is it legal to scrape Truth?

The Truth Social Posts Scraper collects only publicly available data. If results contain personal data, process it under GDPR or the rules that apply to you, and only for a legitimate purpose.

#### Which formats can I download?

The Truth Social Posts Scraper dataset downloads as JSON, CSV, Excel (XLSX), XML, RSS or an HTML table, and the Apify API returns the same Truth Social Posts Scraper data page by page.

#### What is the best Truth scraper for social posts?

The Truth Social Posts Scraper is built for exactly this job: public Truth social posts, complete fields, no login, pay per result and a clean export to JSON, CSV or Excel.

#### Can I schedule it?

Yes. Apify schedules run the Truth Social Posts Scraper hourly, daily or weekly, and a webhook can notify your system when new Truth data is ready.

#### Can I send the data to my CRM?

Yes. Push Truth Social Posts Scraper rows to HubSpot, Salesforce, Pipedrive or any CRM through Zapier, Make or a webhook - a common setup for an agency or B2B sales team.

#### How do I get more results?

Raise the maximum items, add more inputs (keywords, URLs or profiles), or run the Truth Social Posts Scraper several times on a schedule. Results are de-duplicated.

#### Can I run it for many inputs at once?

Yes. Give the Truth Social Posts Scraper a list of inputs in one run; each row says which input it came from, so one Truth Social Posts Scraper run can cover a whole list.

#### How is this different from other Truth scrapers?

The Truth Social Posts Scraper combines complete public fields, no login, pay-per-result pricing and a stable output schema, so the Truth Social Posts Scraper fits both quick one-off exports and long-running automation.

#### How much does it cost?

The Truth Social Posts Scraper is pay per result: you pay only for the rows you receive, with lower prices on higher Apify plans. You can cap the cost of every run with the maximum cost setting.

#### How fast is it?

The Truth Social Posts Scraper runs requests in parallel and rotates proxy sessions automatically, so a typical run of a few hundred items finishes in minutes.

#### Why is a field empty in my results?

The Truth Social Posts Scraper fills every field Truth publishes for that item. When Truth does not show a value - for example a figure the owner hid - the field stays empty rather than being guessed.

#### Can it replace the official Truth API?

For public data, yes. The Truth Social Posts Scraper gives you Truth data through the Apify API without an official Truth API key, quota approval or developer account.

### Get started

Open the Truth Social Posts Scraper, paste your input and press Start. In a few minutes the Truth Social Posts Scraper hands you clean Truth data as JSON, CSV or Excel, ready for analytics, monitoring, research or your CRM. Questions or a missing field? Write to us from the Truth Social Posts Scraper page on Apify - we answer fast and add features users ask for.

### More scrapers from Neuro Scraper

| Actor | What it extracts |
|---|---|
| ⭐ **[Facebook Reels Scraper](https://apify.com/neuro-scraper/facebook-reels-scraper)** | Facebook Reels with exact views, plays, every reaction type, comments and shares |
| [Snapchat Profile Scraper](https://apify.com/neuro-scraper/snapchat-profile-scraper) | Snapchat profile data with all public fields, exported to JSON, CSV or Excel |
| [Amazon Scraper](https://apify.com/neuro-scraper/amazon-keyword-scraper) | Amazon data with all public fields, exported to JSON, CSV or Excel |
| [Instagram Reels Scraper](https://apify.com/neuro-scraper/instagram-reels-scraper) | Instagram reels with all public fields, exported to JSON, CSV or Excel |
| [Facebook Video Details Scraper](https://apify.com/neuro-scraper/facebook-video-details-scraper) | Facebook video details with all public fields, exported to JSON, CSV or Excel |
| [Facebook Reels Scraper Advanced](https://apify.com/neuro-scraper/facebook-reels-scraper-advanced) | Facebook reels  advanced data with all public fields, exported to JSON, CSV or Excel |
| [Facebook Reels Downloader](https://apify.com/neuro-scraper/facebook-reels-downloader) | Facebook reels with all public fields, exported to JSON, CSV or Excel |
| [Instagram Search Scraper](https://apify.com/neuro-scraper/instagram-video-scraper-advanced) | Instagram search data with all public fields, exported to JSON, CSV or Excel |
| [TikTok Video Details Scraper](https://apify.com/neuro-scraper/tiktok-video-details-scraper) | TikTok video details with all public fields, exported to JSON, CSV or Excel |
| [Instagram Hashtag Scraper](https://apify.com/neuro-scraper/instagram-reeel-scraper) | Instagram hashtag data with all public fields, exported to JSON, CSV or Excel |
| [TikTok Profile Scraper](https://apify.com/neuro-scraper/tiktok-profile-scraper) | TikTok profile data with all public fields, exported to JSON, CSV or Excel |
| [Amazon Best Sellers Scraper](https://apify.com/neuro-scraper/amazon-per-result-scraper) | Amazon best sellers with all public fields, exported to JSON, CSV or Excel |
| [Facebook Photos Scraper](https://apify.com/neuro-scraper/facebook-photo-posts-scraper) | Facebook photos with all public fields, exported to JSON, CSV or Excel |

# Actor input Schema

## `usernames` (type: `array`):

Truth Social profiles, one per line: a username (realDonaldTrump), @handle (@JackPosobiec) or profile URL (https://truthsocial.com/@realDonaldTrump). Only profiles Truth Social shows to logged-out visitors return posts; the log names any profile that shows none.

## `postUrls` (type: `array`):

Optional. Specific posts to fetch, one per line: a post URL (https://truthsocial.com/@realDonaldTrump/posts/117408959105269388) or a bare post ID. One row per post.

## `mode` (type: `string`):

posts = the profile's posts and ReTruths (replies left out by the server); posts_and_replies = everything the profile wrote; replies = only its replies; profile = one profile-details row per profile (followers, posts count, bio, avatar ...), no posts. Trending content needs a logged-in account on Truth Social and is not offered.

## `maxPosts` (type: `integer`):

How many posts to save for each profile. Pages of 20 (the server's fixed page size) are followed with Truth Social's own max_id cursor until this number, the date limit or the profile's first post. 0 = the whole history.

## `onlyMedia` (type: `boolean`):

Keep only posts with images or videos (Truth Social's own only_media filter).

## `includeReblogs` (type: `boolean`):

Keep ReTruths of other people's posts. Turned off, they are dropped as pages are read (the server ignores its exclude_reblogs parameter - measured), so Max posts counts own posts only.

## `postsNewerThan` (type: `string`):

Optional. Keep only posts published on or after this date (YYYY-MM-DD or ISO date-time), or a relative age such as '7 days' / '12 hours'. Posts come newest first, so paging stops at the first older post.

## `startFromId` (type: `string`):

Optional. Start below this post ID (or post URL): only posts older than it are returned. Useful to continue a long history in several runs.

## `continueFromLastPostId` (type: `boolean`):

Monitoring mode: remember the newest post ID per profile in the named key-value store 'truth-social-posts-state' and, on the next run, stop at that post - only new posts are saved.

## `peek` (type: `boolean`):

With 'Only new posts since the last run': return the new posts but leave the saved post ID where it is, so the next normal run still returns them (a quick 'anything new?' check).

## `cleanContent` (type: `boolean`):

content as plain text (paragraphs kept as line breaks). Turned off, content keeps Truth Social's HTML. contentHtml always has the HTML.

## `proxyConfiguration` (type: `object`):

Apify residential proxies in the United States are the default and recommended (the API sits behind Cloudflare).

## Actor input object example

```json
{
  "usernames": [
    "realDonaldTrump"
  ],
  "postUrls": [],
  "mode": "posts",
  "maxPosts": 20,
  "onlyMedia": false,
  "includeReblogs": true,
  "continueFromLastPostId": false,
  "peek": false,
  "cleanContent": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "usernames": [
        "realDonaldTrump"
    ],
    "postUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("neuro-scraper/truth-social-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "usernames": ["realDonaldTrump"],
    "postUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("neuro-scraper/truth-social-posts-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "usernames": [
    "realDonaldTrump"
  ],
  "postUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call neuro-scraper/truth-social-posts-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neuro-scraper/truth-social-posts-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Uyvz4Pm7fXGJP8kuD/builds/OKbbNEAP15257bhs8/openapi.json
