# Truth Social Scraper: Posts, Profiles, Engagement, No Login (`transparent_meteorite/truth-social-scraper`) Actor

Scrape public Truth Social profiles and posts without a login: post text, ISO dates, likes, reposts, replies, engagement rate, hashtags, mentions, links, media URLs, plus follower counts, bio and verified flag. Filter by date, media, replies and reposts.

- **URL**: https://apify.com/transparent_meteorite/truth-social-scraper.md
- **Developed by:** [Detroit Web Agent - Open Data](https://apify.com/transparent_meteorite) (community)
- **Categories:** Social media, News
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.03 / 1,000 result rows

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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 Scraper: Posts, Profiles, Engagement, No Login

Truth Social scraper for public profiles and posts. Give it one or more usernames and it returns each account's profile (followers, following, post count, bio, verified flag, join date) and its latest posts (truths) with plain text, ISO dates, likes, reposts, replies, engagement rate, hashtags, mentions, links and media URLs. No Truth Social account, cookie, API key or password is needed. Export to JSON, CSV, Excel or the API.

### Run in 30 seconds

1. Open the **Input** tab. The prefilled input already works: it scrapes the latest 40 posts of one public account.
2. Add the usernames you care about (`realDonaldTrump`, `@name` or a profile URL).
3. Click **Start**. A 40-post run finishes in about 20 seconds.
4. Open the **Posts** or **Profiles** view in the dataset, or download the rows as JSON, CSV or Excel.

### What does this Actor do?

It reads the same public information any visitor sees on truthsocial.com without logging in. For every account you list it returns:

- **One profile row** (optional): username, display name, bio text, followers, following, total posts, verified flag, bot / locked / group flags, location, website, profile link fields, avatar and header image, join date and the date of the latest post.
- **Post rows**, newest first: the post text as plain text and as the original HTML, ISO 8601 timestamps, edit time, language, visibility, likes, reposts, replies, upvotes, downvotes, a ready-made engagement count and engagement rate, hashtags, mentions, links found in the text, every media item (type, URL, preview URL, description, width, height), link preview cards, polls, quote and reply references, sensitive and sponsored flags, pinned flag, character and word counts.
- **Reposts (ReTruths)** are kept by default and carry the original text, media and author, with `isReblog` set and `rebloggedByUsername` telling you who shared it.
- **Status rows** for inputs that returned nothing (account not found, blocked, no matching posts, invalid input). They explain what happened, they are never billed and the run still ends as Succeeded.
- **Single posts** by URL or numeric ID if you already have a list of links.

Typical uses: monitoring statements by public officials and agencies, news and media tracking, political and market sentiment research, brand and ticker mentions, academic datasets, archiving a public figure's posts, and feeding an alert or an AI summary with fresh posts every day.

### Limits

- **Public, logged-out data only.** Search, hashtag timelines, the trending list, reply threads, follower lists and like lists need a Truth Social login and are not available. They are not scraped and this Actor never asks for credentials.
- **Posts per account:** newest first, up to 5,000 per account per run, 20 per page. Deep history takes more pages and more time; use **Only posts newer than** to stop at a date.
- **Datacenter IPs are blocked by Truth Social.** The default Apify residential proxy (US) is required and already set.
- Counts such as likes and followers are the live numbers at scrape time. Posts removed by Truth Social are not returned.

### Input

| Field | What it does | Default |
|---|---|---|
| `usernames` | Usernames, @handles or profile URLs | `realDonaldTrump` |
| `postUrls` | Single posts by URL or numeric ID (optional) | empty |
| `maxPostsPerUser` | Newest posts per account, 0 to 5,000 (0 = profile only) | 40 |
| `onlyPostsNewerThan` | ISO date (`2026-11-01`) or relative age (`7 days`, `12 hours`) | none |
| `includeProfile` | One profile row per account | on |
| `includeReplies` | Include the account's replies to other users | off |
| `includeReblogs` | Include reposts | on |
| `onlyMedia` | Only posts with images or video | off |
| `maxItems` | Hard cap on billed rows for the whole run | none |
| `maxConcurrency` | Accounts fetched in parallel, 1 to 5 | 3 |
| `proxyConfiguration` | Keep the default residential proxy | RESIDENTIAL, US |

### Example input

```json
{
  "usernames": ["realDonaldTrump", "https://truthsocial.com/@WhiteHouse"],
  "maxPostsPerUser": 100,
  "onlyPostsNewerThan": "7 days",
  "includeReplies": false,
  "includeReblogs": true
}
```

### Output sample

One post row (shortened):

```json
{
  "type": "post",
  "id": "117629573147086367",
  "url": "https://truthsocial.com/@realDonaldTrump/117629573147086367",
  "createdAt": "2026-11-17T03:07:24.162Z",
  "text": "...",
  "authorUsername": "realDonaldTrump",
  "authorFollowersCount": 13196991,
  "isReblog": false,
  "isReply": false,
  "repliesCount": 3047,
  "reblogsCount": 3297,
  "likesCount": 11947,
  "engagementCount": 18291,
  "engagementRatePct": 0.1386,
  "hashtags": [],
  "mentions": [],
  "links": [],
  "media": [{"type": "image", "url": "https://static-assets-1.truthsocial.com/...jpg", "width": 1336, "height": 768}],
  "mediaCount": 1,
  "sourceUrl": "https://truthsocial.com/@realDonaldTrump",
  "scrapedAt": "2026-11-17T20:41:00.000Z",
  "status": "ok"
}
```

One profile row has `type: "profile"`, `username`, `displayName`, `bio`, `followersCount`, `followingCount`, `postsCount`, `verified`, `createdAt`, `lastPostDate`, `website`, `avatarUrl` and the same `sourceUrl`, `scrapedAt` and `status` fields. A status row looks like `{"type": "status", "status": "not_found", "message": "Account @x does not exist (or was suspended).", "sourceUrl": "..."}`.

Every row has the same `type`, `status`, `message`, `sourceUrl` and `scrapedAt` fields, so one filter (`type == "post"`) separates posts from profiles and notes.

### Use cases

- **Statement monitoring.** Schedule a daily run with `onlyPostsNewerThan: "1 day"` and send new posts to Slack, email or a spreadsheet.
- **Sentiment and market research.** Combine text, hashtags, mentions and engagement rate to see which posts move attention.
- **Newsroom and research archives.** Keep ISO timestamps, original HTML and media URLs together with a source URL and a scrape time.
- **Competitor and account comparison.** Compare followers, posting frequency and engagement rate across public accounts.
- **AI pipelines.** Plain `text` plus `hashtags`, `mentions` and `links` arrive pre-parsed, so no cleaning step is needed before a summary or classifier.

### Pricing and cost control

Pay per event. You pay a small start fee per run and one price per delivered row (a post or a profile). Status rows are free. Higher Apify plans get lower prices automatically.

| Event | Free | Bronze | Silver | Gold | Platinum | Diamond |
|---|---|---|---|---|---|---|
| Actor start (per run) | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 |
| Result row (per 1,000) | $2.50 | $2.34 | $2.19 | $2.03 | $2.03 | $2.03 |

Examples at the Free price: 40 posts plus a profile cost about $0.10; 1,000 posts cost about $2.50. Set **Max rows in total** (`maxItems`) or Apify's own **Maximum cost per run** to cap spend: the run stops cleanly when the limit is reached and keeps every row already delivered.

### Integrations and scheduling

Use the Apify **Schedules** tab for hourly or daily runs, **Integrations** for Google Sheets, Slack, email and webhooks, or call the Actor from Make, Zapier or n8n. Each run writes to its own dataset, which you can download as JSON, CSV, XML, Excel or HTML.

### Use with the API, n8n, Make, Zapier or AI agents

Start a run over the API:

```bash
curl -X POST "https://api.apify.com/v2/acts/transparent_meteorite~truth-social-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["realDonaldTrump"],"maxPostsPerUser":20}'
```

- **n8n:** add an HTTP Request node with the URL above, or the Apify node's "Run Actor" operation with actor `transparent_meteorite/truth-social-scraper`, then read the returned items.
- **Make and Zapier:** use the Apify app's "Run Actor" step, paste the input JSON and map the dataset items to your sheet or message.
- **AI agents (MCP):** connect the Apify MCP server at `https://mcp.apify.com?tools=transparent_meteorite/truth-social-scraper` to Claude, Cursor or any MCP client and your agent can call this Actor as a tool.

### Fair use and legal

The Actor reads only information Truth Social already shows publicly to any visitor. It does not log in, use accounts or cookies, read private or locked content, or bypass any wall. Respect the rights of the people whose posts you collect and the privacy and data-protection rules that apply to you, especially if you store or publish personal data. This is an independent tool and is not affiliated with Truth Social or Trump Media & Technology Group.

### FAQ

**Do I need a Truth Social account or API key?** No. Nothing but your Apify account.

**Can it search by keyword or hashtag, or read the trending list?** Not in this version: those views require a login on Truth Social and this Actor only reads public logged-out data. Account timelines and single posts are fully supported.

**Why a residential proxy?** Truth Social blocks datacenter IP ranges. The Actor is preconfigured with the Apify residential proxy; the proxy traffic cost is included in the per-row price you see above.

**How many posts can I get?** Up to 5,000 per account per run, newest first. Use `onlyPostsNewerThan` to avoid paying for old posts.

**Why did I get fewer posts than I asked for?** The account has fewer public posts, your filters (replies, reposts, media, date) removed some, or the run reached your row or cost limit. A status row says which.

**Are replies included?** Not by default. Switch on `includeReplies` to add the account's replies to other users. Threads under a post (other people's replies) need a login and are not available.

**What happens with a bad username?** The run still ends as Succeeded and writes a free status row such as `not_found` or `invalid_input` explaining the problem.

**Is the engagement rate exact?** It is `(likes + reposts + replies) / followers x 100` using the author's follower count at scrape time, so it is a consistent comparison number, not an official platform metric.

**Can I get only new posts every day?** Yes: schedule the Actor daily and set `onlyPostsNewerThan` to `1 day` (or a few hours more than your interval to avoid gaps), then de-duplicate on `id`.

### Support

Found an account that reads badly? Open an issue on the Issues tab with the run URL and the username.

### Related actors

- [Instagram Profile Scraper](https://apify.com/transparent_meteorite/instagram-public-profile-scraper) for followers, bio links and recent posts from public Instagram accounts.
- [TikTok Profile Scraper](https://apify.com/transparent_meteorite/tiktok-public-profile-scraper) for public TikTok account stats and videos.
- [YouTube Channel Scraper](https://apify.com/transparent_meteorite/youtube-channel-scraper) for channel stats and uploads.

### Changelog

- **0.2**: Profiles, posts by account, single posts, date filter, replies / reposts / media filters, engagement rate, parsed hashtags, mentions and links, status rows.

# Actor input Schema

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

Public accounts: a username (realDonaldTrump), an @handle or a profile URL (https://truthsocial.com/@realDonaldTrump). One profile row plus posts per account.

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

Single posts (truths): a post URL such as https://truthsocial.com/@realDonaldTrump/115000000000000000 or the numeric post ID. One row per post.

## `maxPostsPerUser` (type: `integer`):

Newest posts first, 20 per page. 0 returns only the profile row.

## `onlyPostsNewerThan` (type: `string`):

Stop at this age: an ISO date (2026-11-01) or a relative age (7 days, 12 hours, 2 weeks). Leave empty for no limit.

## `includeProfile` (type: `boolean`):

Adds one row per account with followers, following, post count, bio, verified flag and join date. Each row is billed like a post.

## `includeReplies` (type: `boolean`):

Also return the account's replies to other users. Off by default: only original posts and reposts.

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

Include posts the account re-shared. Reposts carry the original text and author, with isReblog=true.

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

Keep only posts that contain an image or video.

## `maxItems` (type: `integer`):

Hard cap on billed rows across all accounts (profiles + posts). 0 or empty means no cap beyond the per-account limit.

## `maxConcurrency` (type: `integer`):

How many accounts are fetched at the same time.

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

Truth Social blocks datacenter IPs. Keep the default Apify residential proxy (US).

## Actor input object example

```json
{
  "usernames": [
    "realDonaldTrump"
  ],
  "maxPostsPerUser": 40,
  "includeProfile": true,
  "includeReplies": false,
  "includeReblogs": true,
  "onlyMedia": false,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `posts` (type: `string`):

No description

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

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

// Run the Actor and wait for it to finish
const run = await client.actor("transparent_meteorite/truth-social-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"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("transparent_meteorite/truth-social-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"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call transparent_meteorite/truth-social-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,transparent_meteorite/truth-social-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/bCKmHvjx1VrzkaNms/builds/DMPTYmL8fnsPiipNN/openapi.json
