# Truth Social Scraper — Profiles, Posts & Monitor (`scrapingmonkey/truth-social-scraper`) Actor

Scrape public Truth Social profiles, timelines, pinned and media posts, individual Truths, engagement, polls, cards, and oEmbed records. Monitor multiple accounts without login.

- **URL**: https://apify.com/scrapingmonkey/truth-social-scraper.md
- **Developed by:** [ScrapingMonkey](https://apify.com/scrapingmonkey) (community)
- **Categories:** Automation, News, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.30 / 1,000 profile results

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Scraper - Profiles, Posts, Timelines and Monitoring

Collect public Truth Social profiles, account timelines, individual Truths, pinned posts, media posts, and engagement data in a clean Apify dataset.

- Extract profile names, handles, bios, verification flags, avatars, headers, and audience counts
- Paginate public account timelines and choose whether to include replies and Retruths
- Collect individual Truths, pinned posts, and media-only timelines with text, media, dates, visibility, and engagement
- Preserve available mentions, hashtags, emojis, link cards, polls, quotes, and Retruth relationships
- Monitor public accounts and save only new or changed Truths on scheduled runs
- Process multiple handles, profile URLs, Truth IDs, and post URLs in one run
- No Truth Social account, cookies, browser, or user-supplied proxy is required; requests use the built-in Apify Residential Proxy
- Export results to JSON, CSV, Excel, XML, RSS, or access them through the Apify API

### What can you do with this Actor?

| Mode / action | Input | Output | Best for |
| --- | --- | --- | --- |
| `timelines` | Public handles or profile URLs | Cursor-paginated public `truth` rows | Content research, publishing analysis, and social listening |
| `profiles` | Public handles or profile URLs | One normalized `profile` row per target | Audience and creator research |
| `truths` | Truth IDs or full public Truth URLs | Complete public `truth` rows | Post-level content, media, and engagement analysis |
| `pinned` | Public handles or profile URLs | Pinned public `truth` rows | Tracking prominently featured posts |
| `media` | Public handles or profile URLs | Public `truth` rows that contain media | Media monitoring and asset discovery |
| `oembed` | Full public Truth URLs | Lightweight `oembed` rows | Embeds, previews, and link enrichment |
| `auto` | Mixed public profile and Truth targets | `profile` or `truth` rows selected from each target | Batch processing mixed known targets |
| `monitor` | Public handles plus a stable `monitorKey` | Only new or new-and-changed `truth` rows | Scheduled account monitoring |

Choose one mode per run. Multiple targets can be processed together, and `maxItems` applies separately to each timeline-style target.

### Quick start

1. Open the Actor and click **Try for free**.
2. Keep **Timelines** selected or choose another workflow.
3. Enter one or more public handles, profile URLs, Truth IDs, or post URLs and set the result limit.
4. Click **Start**.
5. Preview the single **Results** table or download it in your preferred format.

The default input collects the public timeline for `realDonaldTrump` and is ready to run.

### Input examples

#### Public timeline

```json
{
  "mode": "timelines",
  "targets": [
    "realDonaldTrump"
  ],
  "maxItems": 100,
  "country": "US"
}
```

#### Profiles

```json
{
  "mode": "profiles",
  "targets": [
    "realDonaldTrump",
    "truthsocial"
  ],
  "country": "US"
}
```

#### Truth details

```json
{
  "mode": "truths",
  "targets": [
    "114000000000000000"
  ],
  "country": "US"
}
```

#### oEmbed

```json
{
  "mode": "oembed",
  "targets": [
    "https://truthsocial.com/@truthsocial/114000000000000000"
  ],
  "country": "US"
}
```

#### Pinned Truths

```json
{
  "mode": "pinned",
  "targets": [
    "realDonaldTrump"
  ],
  "maxItems": 20,
  "country": "US"
}
```

#### Media Truths

```json
{
  "mode": "media",
  "targets": [
    "realDonaldTrump"
  ],
  "maxItems": 50,
  "country": "US"
}
```

#### Monitor a public timeline

```json
{
  "mode": "monitor",
  "targets": [
    "realDonaldTrump"
  ],
  "maxItems": 100,
  "monitorMode": "onlyNew",
  "monitorKey": "truth-account-daily",
  "country": "US"
}
```

#### Auto-detect mixed public targets

```json
{
  "mode": "auto",
  "targets": [
    "realDonaldTrump",
    "https://truthsocial.com/@truthsocial/114000000000000000"
  ],
  "country": "US"
}
```

`maxItems` limits retained timeline, pinned, or media rows per target. Profile, individual Truth, and oEmbed requests normally return one row per target.

### Complete output examples

Every result row contains exactly 56 top-level fields. The same complete key set makes mixed result types predictable in JSON exports and keeps every field visible in the single Results view.

#### Complete `profile` row — 56 top-level fields

```json
{
  "recordType": "profile",
  "sourceMode": "profiles",
  "sourceTarget": "example-target",
  "sourceUrl": "https://example.com/public-result",
  "sourceEndpoints": [],
  "id": "example-id",
  "uri": "example-id",
  "url": "https://example.com/public-result",
  "username": null,
  "acct": null,
  "displayName": "Example public record",
  "profileUrl": "https://example.com/public-result",
  "createdAt": "2026-08-13T12:00:00Z",
  "publishedAt": "2026-08-13T12:00:00Z",
  "indexedAt": "2026-08-13T12:00:00Z",
  "contentText": "Example public content",
  "contentHtml": "Example public content",
  "bioText": "Example public content",
  "bioHtml": "Example public content",
  "language": null,
  "visibility": null,
  "sensitive": false,
  "spoilerText": null,
  "verified": false,
  "locked": false,
  "bot": false,
  "discoverable": false,
  "group": false,
  "avatarUrl": "https://cdn.example.com/image.jpg",
  "headerUrl": "https://cdn.example.com/image.jpg",
  "followersCount": 0,
  "followingCount": 0,
  "postsCount": 0,
  "repliesCount": 0,
  "retruthedCount": 0,
  "likesCount": 0,
  "inReplyToId": "example-id",
  "inReplyToAccountId": "example-id",
  "quoteId": "example-id",
  "pinned": false,
  "mediaAttachments": [],
  "mentions": [],
  "hashtags": [],
  "emojis": [],
  "card": {},
  "poll": {},
  "retruthedTruth": {},
  "quotedTruth": {},
  "author": {},
  "oembed": {},
  "isPartial": false,
  "monitorStatus": null,
  "changedFields": [],
  "previousCapturedAt": "2026-08-13T12:00:00Z",
  "capturedAt": "2026-08-13T12:00:00Z",
  "raw": {}
}
```

#### Complete `truth` row — 56 top-level fields

```json
{
  "recordType": "truth",
  "sourceMode": "timelines",
  "sourceTarget": "example-target",
  "sourceUrl": "https://example.com/public-result",
  "sourceEndpoints": [],
  "id": "example-id",
  "uri": "example-id",
  "url": "https://example.com/public-result",
  "username": null,
  "acct": null,
  "displayName": "Example public record",
  "profileUrl": "https://example.com/public-result",
  "createdAt": "2026-08-13T12:00:00Z",
  "publishedAt": "2026-08-13T12:00:00Z",
  "indexedAt": "2026-08-13T12:00:00Z",
  "contentText": "Example public content",
  "contentHtml": "Example public content",
  "bioText": "Example public content",
  "bioHtml": "Example public content",
  "language": null,
  "visibility": null,
  "sensitive": false,
  "spoilerText": null,
  "verified": false,
  "locked": false,
  "bot": false,
  "discoverable": false,
  "group": false,
  "avatarUrl": "https://cdn.example.com/image.jpg",
  "headerUrl": "https://cdn.example.com/image.jpg",
  "followersCount": 0,
  "followingCount": 0,
  "postsCount": 0,
  "repliesCount": 0,
  "retruthedCount": 0,
  "likesCount": 0,
  "inReplyToId": "example-id",
  "inReplyToAccountId": "example-id",
  "quoteId": "example-id",
  "pinned": false,
  "mediaAttachments": [],
  "mentions": [],
  "hashtags": [],
  "emojis": [],
  "card": {},
  "poll": {},
  "retruthedTruth": {},
  "quotedTruth": {},
  "author": {},
  "oembed": {},
  "isPartial": false,
  "monitorStatus": null,
  "changedFields": [],
  "previousCapturedAt": "2026-08-13T12:00:00Z",
  "capturedAt": "2026-08-13T12:00:00Z",
  "raw": {}
}
```

#### Complete `oembed` row — 56 top-level fields

```json
{
  "recordType": "oembed",
  "sourceMode": "oembed",
  "sourceTarget": "example-target",
  "sourceUrl": "https://example.com/public-result",
  "sourceEndpoints": [],
  "id": "example-id",
  "uri": "example-id",
  "url": "https://example.com/public-result",
  "username": null,
  "acct": null,
  "displayName": "Example public record",
  "profileUrl": "https://example.com/public-result",
  "createdAt": "2026-08-13T12:00:00Z",
  "publishedAt": "2026-08-13T12:00:00Z",
  "indexedAt": "2026-08-13T12:00:00Z",
  "contentText": "Example public content",
  "contentHtml": "Example public content",
  "bioText": "Example public content",
  "bioHtml": "Example public content",
  "language": null,
  "visibility": null,
  "sensitive": false,
  "spoilerText": null,
  "verified": false,
  "locked": false,
  "bot": false,
  "discoverable": false,
  "group": false,
  "avatarUrl": "https://cdn.example.com/image.jpg",
  "headerUrl": "https://cdn.example.com/image.jpg",
  "followersCount": 0,
  "followingCount": 0,
  "postsCount": 0,
  "repliesCount": 0,
  "retruthedCount": 0,
  "likesCount": 0,
  "inReplyToId": "example-id",
  "inReplyToAccountId": "example-id",
  "quoteId": "example-id",
  "pinned": false,
  "mediaAttachments": [],
  "mentions": [],
  "hashtags": [],
  "emojis": [],
  "card": {},
  "poll": {},
  "retruthedTruth": {},
  "quotedTruth": {},
  "author": {},
  "oembed": {},
  "isPartial": false,
  "monitorStatus": null,
  "changedFields": [],
  "previousCapturedAt": "2026-08-13T12:00:00Z",
  "capturedAt": "2026-08-13T12:00:00Z",
  "raw": {}
}
```

### What data can you extract?

| Category | Fields |
| --- | --- |
| Source and capture | `recordType`, `sourceMode`, `sourceTarget`, `sourceUrl`, `sourceEndpoints`, `capturedAt` |
| Identity and author | `id`, `uri`, `url`, `username`, `acct`, `displayName`, `profileUrl`, `author` |
| Dates and content | `createdAt`, `publishedAt`, `indexedAt`, `contentText`, `contentHtml`, `bioText`, `bioHtml`, `language`, `visibility`, `sensitive`, `spoilerText` |
| Account flags and media | `verified`, `locked`, `bot`, `discoverable`, `group`, `avatarUrl`, `headerUrl` |
| Audience and engagement | `followersCount`, `followingCount`, `postsCount`, `repliesCount`, `retruthedCount`, `likesCount` |
| Relationships | `inReplyToId`, `inReplyToAccountId`, `quoteId`, `pinned` |
| Structured post data | `mediaAttachments`, `mentions`, `hashtags`, `emojis`, `card`, `poll`, `retruthedTruth`, `quotedTruth`, `oembed` |
| Monitoring and diagnostics | `isPartial`, `monitorStatus`, `changedFields`, `previousCapturedAt`, `raw` |

Nested fields such as `author`, `mediaAttachments`, `mentions`, `hashtags`, `emojis`, `card`, `poll`, `retruthedTruth`, `quotedTruth`, `oembed`, and optional `raw` retain Truth Social's public API structure. Their nested keys are source-controlled and can change; the 56 top-level keys above are fixed by the Actor.

### Input parameters

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `mode` | `string` | No | `"timelines"` | `auto`, `profiles`, `timelines`, `truths`, `pinned`, `media`, `oembed`, or `monitor`. |
| `targets` | `string[]` | Yes for selected mode | `["realDonaldTrump"]` | Handles or profile URLs for account modes, Truth IDs/URLs for details, and full Truth URLs for oEmbed. |
| `maxItems` | `integer` | No | `100` | Maximum retained timeline-style rows per target, from 1 to 10,000. |
| `maxPages` | `integer` | No | `20` | Maximum cursor pages per timeline target, from 1 to 500. |
| `includeReplies` | `boolean` | No | `true` | Include public replies present in account timelines. |
| `includeRetruths` | `boolean` | No | `true` | Include public boosted or Retruthed records. |
| `maxConcurrency` | `integer` | No | `5` | Concurrent public targets, from 1 to 20. |
| `country` | `string` | No | `"US"` | Two-letter ISO country used for the internal residential proxy region. |
| `includeRaw` | `boolean` | No | `false` | Include the redacted public source object; increases dataset size. |
| `monitorMode` | `string` | No | `"off"` | `off`, `onlyNew`, or `newAndChanged`. |
| `monitorKey` | `string` | With monitoring | `"default"` | Stable comparison-state namespace for recurring runs. |
| `maxSessionRotations` | `integer` | No | `3` | Fresh residential sessions tried after blocks, from 1 to 6. |
| `requestTimeoutSecs` | `integer` | No | `45` | Per-request timeout in seconds, from 15 to 120. |

### Pay-per-event result types

| Event | Charged when |
| --- | --- |
| `profile-result` | One `profile` row is accepted by the Dataset. |
| `truth-result` | One `truth` row is accepted by the Dataset. |
| `oembed-result` | One `oembed` row is accepted by the Dataset. |

The Actor does not emit a paid error event. Failed targets are counted by category in `RUN_SUMMARY`; successful targets continue. Actual event prices are shown on the Actor's Pricing tab.

### Use cases

#### Track public accounts and publishing activity

Collect profiles, timelines, pinned posts, and media posts for creator, political, media, and brand research.

#### Analyze content and engagement

Compare public text, media, replies, Retruths, likes, cards, polls, and account metrics in a consistent dataset.

#### Build recurring monitoring workflows

Run scheduled `monitor` jobs and send new rows through webhooks to Google Sheets, Airtable, Make, Zapier, n8n, Airbyte, or a data warehouse.

### Performance and cost

Direct HTTP generally uses substantially less memory and bandwidth than launching a browser, but source response size, retries, optional enrichment, raw objects, and pagination determine actual cost. Start with a small limit, inspect the Dataset and RUN\_SUMMARY, then scale. Lower concurrency is usually more reliable on stricter public sites.

### API usage

Replace `YOUR_USERNAME` with the publishing Apify username after publication:

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/YOUR_USERNAME~truth-social-scraper/runs?token=APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "timelines",
    "targets": ["realDonaldTrump"],
    "maxItems": 100,
    "country": "US"
  }'
```

The request body is the same JSON used in Apify Console. Read results from the run's default Dataset or use the output link that opens `view=overview`.

### Best for / not for

**Best for:** public profile enrichment, account timeline exports, post-level research, pinned/media monitoring, and lightweight oEmbed enrichment.

**Not for:** private posts, follower lists, global search, discussion-context expansion, authenticated feeds, groups, or account actions.

### Limits and good to know

This Actor uses anonymous Mastodon-compatible endpoints exposed by Truth Social. Search, discussion-context expansion, private posts, follower lists, and authenticated timelines are intentionally not claimed.

A missing public value is returned as `null` or an empty array. One failed input does not create a frightening error row in Results. If every input fails, the run fails after writing diagnostic counts to RUN\_SUMMARY.

### Frequently asked questions

#### What input should I provide?

Use public handles or profile URLs for profile and timeline modes, Truth IDs or full URLs for `truths`, and full public Truth URLs for `oembed`.

#### How many results can I extract?

`maxItems` accepts 1-10,000 per timeline-style target, while `maxPages` accepts 1-500. Source availability, deleted content, and cursor exhaustion can return fewer rows.

#### Can I process multiple inputs?

Yes. Add multiple values to `targets`; failures are isolated per target and successful targets continue.

#### Can I schedule recurring runs?

Yes. Use Apify schedules with `mode: "monitor"` and a stable `monitorKey`, then connect webhooks for downstream automation.

#### Does this Actor open a browser?

No. Runtime extraction uses direct HTTP only and contains no Playwright, Selenium, Chromium, or browser installation.

#### Do I need an account or cookies?

No. The supported modes use public pages and anonymous endpoints. Cookies or authorization values from research captures are never embedded in the release.

#### Do I need to configure a proxy?

No. On Apify, the Actor creates a Residential Proxy configuration internally and does not expose proxy settings in Input. Local developers may privately point the documented test-only environment variable at a proxy file; that variable is not an Actor input and is ignored on the platform.

#### Why are some fields empty?

The single Results view covers every result type. Fields that do not apply to a row remain empty, while the complete key set is preserved in JSON.

### Responsible use

Collect only public Truth Social data you are permitted to process. Respect applicable law, privacy rights, platform terms, rate limits, and intellectual-property rights. This Actor is not affiliated with or endorsed by Truth Social.

### Support

For a reproducible issue, include the Apify run ID, mode, a non-sensitive public target, expected result, and actual result. Never send account credentials, cookies, access tokens, proxy passwords, or private content.

### Local development

For local read-only smoke tests only, `TRUTH_TEST_PROXY_FILE` may point to a private file containing one `login:password@host:port` proxy per line. The file is never read on Apify and must not be committed.

# Actor input Schema

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

Choose profiles, timelines, individual Truths, pinned/media timelines, oEmbed, auto detection, or monitoring.

## `targets` (type: `array`):

Handles for profile/timeline modes, Truth IDs or URLs for details, and full Truth URLs for oEmbed.

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

Maximum timeline records retained for each target. Detail and profile modes return one row.

## `maxPages` (type: `integer`):

Maximum cursor pages requested for each timeline.

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

Include public replies present in account timelines.

## `includeRetruths` (type: `boolean`):

Include public boosted or Retruthed records.

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

Maximum public targets processed at once.

## `country` (type: `string`):

Two-letter ISO country used as the public request region.

## `includeRaw` (type: `boolean`):

Add the complete public source object after cookie, authorization, token, and signature fields are redacted. Increases dataset size.

## `monitorMode` (type: `string`):

Optionally save only new records or new and changed records between named runs.

## `monitorKey` (type: `string`):

Stable namespace for comparison state. Use a different key for independent monitors.

## `maxSessionRotations` (type: `integer`):

Maximum fresh residential proxy sessions tried after blocks, limits, or challenges.

## `requestTimeoutSecs` (type: `integer`):

Maximum time in seconds for one public HTTP request.

## Actor input object example

```json
{
  "mode": "timelines",
  "targets": [
    "realDonaldTrump"
  ],
  "maxItems": 100,
  "maxPages": 20,
  "includeReplies": true,
  "includeRetruths": true,
  "maxConcurrency": 5,
  "country": "US",
  "includeRaw": false,
  "monitorMode": "off",
  "monitorKey": "default",
  "maxSessionRotations": 3,
  "requestTimeoutSecs": 45
}
```

# Actor output Schema

## `dataset` (type: `string`):

All 56 fields in one complete Results table.

## `runSummary` (type: `string`):

Request, retry, failure, byte, result, and charged-event counts.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapingmonkey/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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapingmonkey/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 '{}' |
apify call scrapingmonkey/truth-social-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapingmonkey/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/pdNN5xQPeDVwlWbjt/builds/1vN0lV32RlWr9KXJf/openapi.json