# Truth Social Profile Scraper (`scraper-engine/truth-social-profile-scraper`) Actor

🔍 Truth Social Profile Scraper pulls public profiles at scale—username, name, bio, followers/following, posts count, verified, links, avatar & join date. 📊 Ideal for OSINT, marketing, lead gen & competitor analysis. 🚀 Fast, reliable, API-ready data.

- **URL**: https://apify.com/scraper-engine/truth-social-profile-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 Scraper

Truth Social Profile Scraper collects structured, public profile data from Truth Social at scale — fast, reliable, and ready for analysis. It solves the manual copy‑paste challenge by turning any list of profile URLs or usernames into clean, structured records with follower counts, posts, verification status, and more. Built for marketers, developers, data analysts, and researchers, this Truth Social profile scraper functions as a dependable Truth Social profile data extractor and Truth Social profile scraping tool for dashboards, enrichment, and monitoring — enabling automation and repeatable workflows at scale. 🚀

### What data / output can you get?

Below are the core fields this Truth Social profile crawler saves to your dataset. Success rows contain the real-time timestamp plus fields returned by the public accounts lookup; error rows include the input and error message for full transparency.

| Data type        | Description                                             | Example value |
| ---              | ---                                                     | --- |
| scrapedAt        | ISO-8601 UTC timestamp when the row was saved           | 2026-04-20T12:34:56Z |
| username         | Account handle/username                                 | realDonaldTrump |
| display_name     | Public display name                                     | Donald J. Trump |
| followers_count  | Total number of followers                               | 10000000 |
| statuses_count   | Total number of posts                                   | 5421 |
| verified         | Verification flag (true/false)                          | true |
| url              | Canonical Truth Social profile URL                      | https://truthsocial.com/@realDonaldTrump |
| error            | Error message if the input couldn’t be processed        | Unrecognised URL |
| inputUrl         | The original item you submitted in the input            | https://truthsocial.com/home |

Notes:
- On success, the actor saves all fields returned by the Truth Social accounts lookup API plus scrapedAt. The table above shows the most important fields commonly used in exports and dashboards.
- Export results from Apify in CSV, JSON, or Excel to fit your workflow.

### Key features

- ⚡ Bold-scale collection with real-time saves  
  Each profile is processed one by one and written immediately to the dataset with a Saved at timestamp — perfect for streaming results into dashboards.

- 🛡️ Resilient proxy fallback (data center + residential)  
  Built-in Apify Proxy support with an automatic retry/backoff strategy and a residential fallback path for tough networks, improving stability for large batches.

- 📋 Flexible input: URLs or usernames  
  Paste Truth Social profile URLs or plain usernames — bulk lists are supported for fast setup and repeatable runs.

- 🔌 Developer-friendly & API-ready  
  Results are pushed as structured JSON records in the Apify dataset, making this a seamless Truth Social profile scraper API target for pipelines, webhooks, and apps.

- 🧪 No login required  
  Works on publicly available profiles — no cookies, sessions, or extensions required. No need for a Truth Social scraper chrome extension.

- 💾 Easy exports for analytics  
  Download in CSV, JSON, or Excel from the Apify dataset UI to feed BI tools, CRM enrichment, or research notebooks.

- 🧰 Production-ready reliability  
  Automatic retries, timeouts, and informative status updates keep long runs smooth. Optional proxy configuration helps avoid transient blocks.

### How to use Truth Social Profile Scraper - step by step

1) Sign in to Apify  
Create or log in to your Apify account.

2) Open Truth Social Profile Scraper  
Find and open the “Truth Social Profile Scraper” actor.

3) Add input data  
In “Truth Social URLs or usernames,” paste one item per line. You can use full links like https://truthsocial.com/@username or just the username (with or without @).

4) (Optional) Enable Apify Proxy  
If you expect network issues or see failed runs, open “Apify Proxy” in the input and turn it on. The scraper can also switch to residential routes if needed.

5) Start the run  
Click Start. The actor processes profiles one by one. You’ll see progress logs and real-time status messages in the run.

6) Monitor results in real time  
Each profile is saved to the dataset as soon as it’s fetched, with a scrapedAt timestamp. Invalid inputs are recorded with an error message and your original input.

7) Export your data  
Go to the run’s Dataset tab and export to CSV, JSON, or Excel for analysis, enrichment, or reporting.

Pro Tip: Use the Apify API to trigger runs programmatically and pipe dataset results into your stack — a great way to build automated Truth Social data extraction workflows without writing a full Truth Social profile scraper Python script from scratch.

### Use cases

| Use case name | Description |
| --- | --- |
| Marketing + competitor tracking | Monitor public profiles to track follower growth, posting cadence, and verification status for campaign intelligence. |
| OSINT profile mapping | Aggregate public profile signals (followers_count, statuses_count, verified) into investigative datasets. |
| Lead generation enrichment | Enrich lead lists with public profile URLs and display names to improve matching in CRMs. |
| Analytics dashboards | Feed dashboards with scrapedAt timestamps and key counts to visualize change over time. |
| Academic & media research | Collect structured snapshots of public profiles for studies, articles, and datasets. |
| API & automation pipelines | Trigger runs from your code and consume JSON outputs for downstream processing and alerts. |

### Why choose Truth Social Profile Scraper?

- 🎯 Precision on public profiles only — clean, structured records for analytics and enrichment
- 📈 Built for scale — bulk inputs, automatic retries, and resilient proxy fallback
- 💻 Developer access — API-ready JSON outputs in Apify datasets for easy integration
- 🔒 Safe and ethical defaults — no login, no private data, no risky browser automation
- 🔄 Better than extensions — avoids the instability of manual browser tools and chrome extensions
- 💰 Cost-effective — run what you need and export in the formats you use
- 🔌 Integration-friendly — plug into existing pipelines, from BI tools to internal apps

In short: a production-ready Truth Social profile scraping tool for teams that need reliable, structured data without the fragility of browser-based methods.

### Is it legal / ethical to use Truth Social Profile Scraper?

Yes — when used responsibly. This actor collects data from publicly available Truth Social profiles and does not access private or authenticated content.

Guidelines for responsible use:
- Only collect publicly visible information
- Comply with applicable data protection laws (e.g., GDPR, CCPA)
- Respect platform terms and use scraped data ethically
- Avoid personal or private data processing beyond lawful use
- Consult your legal team if you have edge cases or jurisdiction-specific questions

### Input parameters & output format

Example JSON input
```json
{
  "urls": [
    "https://truthsocial.com/@realDonaldTrump",
    "@exampleuser",
    "anotheruser"
    ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
````

Parameters

- urls (array of string)\
  Description: Paste Truth Social profile URLs or usernames. You can add many at once — processed one by one and saved right away.\
  Prefill: \["https://truthsocial.com/@realDonaldTrump"]\
  Required: Yes

- proxyConfiguration (object)\
  Description: Optional Apify Proxy settings to help reach Truth Social reliably from the cloud. Recommended if you hit errors or blocks.\
  Prefill: {"useApifyProxy": true}\
  Required: No

Example JSON output (success row)

```json
{
  "username": "realDonaldTrump",
  "display_name": "Donald J. Trump",
  "followers_count": 10000000,
  "statuses_count": 5421,
  "verified": true,
  "url": "https://truthsocial.com/@realDonaldTrump",
  "scrapedAt": "2026-04-20T12:34:56Z"
}
```

Example JSON output (error row)

```json
{
  "error": "Unrecognised URL",
  "inputUrl": "https://truthsocial.com/home",
  "scrapedAt": "2026-04-20T12:35:12Z"
}
```

Notes:

- On successful lookups, the actor saves all fields returned by the Truth Social accounts lookup API plus scrapedAt. Keys commonly used include username, display\_name, followers\_count, statuses\_count, verified, and url.
- On invalid inputs or failed requests, the actor records error, inputUrl, and scrapedAt for troubleshooting.
- Export datasets to CSV, JSON, or Excel from the Apify UI.

### FAQ

#### Do I need to log in to use this Truth Social profile scraper?

No. ✅ The actor works with publicly available profiles and does not require login, cookies, or sessions.

#### What types of data does it collect from profiles?

It captures structured profile fields returned by the public lookup and adds a scrapedAt timestamp. Common fields include username, display\_name, followers\_count, statuses\_count, verified, and url. Error rows include error and inputUrl.

#### Can I run this as a Truth Social profile scraper API from my app?

Yes. ✅ As an Apify actor, it’s API-ready. You can start runs and fetch dataset items via the Apify API, making it easy to integrate into pipelines without building a Truth Social profile scraper Python tool yourself.

#### How many profiles can I scrape at once?

You can paste bulk lists of URLs or usernames. The actor processes them one by one with short delays, saving each result as soon as it’s fetched for real-time visibility.

#### What happens if an input isn’t a valid profile?

The actor writes an error row with error, inputUrl, and scrapedAt so you can identify and fix invalid entries quickly.

#### Does it support proxies to avoid network issues?

Yes. ✅ Set proxyConfiguration.useApifyProxy in the input to enable Apify Proxy. The actor also includes an automatic fallback that can switch to residential routes when needed.

#### Does it scrape followers or just the followers count?

It records followers\_count as provided by the public lookup. It does not collect follower lists.

#### Is this a Truth Social scraper chrome extension?

No. ❌ It’s a server-side Apify actor — faster, more reliable, and suitable for automation without browser extensions.

### Closing CTA / Final thoughts

Truth Social Profile Scraper is built for fast, reliable extraction of public Truth Social profile data at scale. Paste a list of usernames or URLs, toggle proxy if needed, and export clean, structured results for analytics, enrichment, or research.

Ideal for marketers, developers, data analysts, and OSINT researchers, it delivers real-time, API-ready JSON you can export to CSV/Excel or pipe into your stack. Developers can programmatically run jobs and consume results via the Apify API to automate full pipelines.

Start extracting smarter Truth Social profile insights today — reliably, ethically, and at scale.

# Actor input Schema

## `urls` (type: `array`):

🔗 Paste Truth Social profile URLs or usernames. You can add many at once — we process them one by one and save each result right away. ⏱️

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

🛡️ Optional: help the actor reach Truth Social reliably from the cloud. Recommended if you hit errors or blocks. 💚

## Actor input object example

```json
{
  "urls": [
    "https://truthsocial.com/@realDonaldTrump"
  ],
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://truthsocial.com/@realDonaldTrump"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper-engine/truth-social-profile-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 = {
    "urls": ["https://truthsocial.com/@realDonaldTrump"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scraper-engine/truth-social-profile-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 '{
  "urls": [
    "https://truthsocial.com/@realDonaldTrump"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scraper-engine/truth-social-profile-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-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Truth Social Profile Scraper",
        "description": "🔍 Truth Social Profile Scraper pulls public profiles at scale—username, name, bio, followers/following, posts count, verified, links, avatar & join date. 📊 Ideal for OSINT, marketing, lead gen & competitor analysis. 🚀 Fast, reliable, API-ready data.",
        "version": "1.0",
        "x-build-id": "aGhaeT9OC7SNuy0Zv"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scraper-engine~truth-social-profile-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scraper-engine-truth-social-profile-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-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scraper-engine-truth-social-profile-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-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scraper-engine-truth-social-profile-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": [
                    "urls"
                ],
                "properties": {
                    "urls": {
                        "title": "Truth Social URLs or usernames",
                        "type": "array",
                        "description": "🔗 Paste Truth Social profile URLs or usernames. You can add many at once — we process them one by one and save each result right away. ⏱️",
                        "items": {
                            "type": "string"
                        }
                    },
                    "proxyConfiguration": {
                        "title": "Apify Proxy",
                        "type": "object",
                        "description": "🛡️ Optional: help the actor reach Truth Social reliably from the cloud. Recommended if you hit errors or blocks. 💚"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```