# Truth Social Account Details (Live data) (`kawsar/truth-social`) Actor
Extract full Truth Social profile data instantly. Get exact follower counts, following lists, account creation dates, bios, avatars, and verification status from any public Truth Social account. Export clean JSON for social media analytics, influence tracking, and PR monitoring
- **URL**: https://apify.com/kawsar/truth-social.md
- **Developed by:** [Kawsar](https://apify.com/kawsar) (community)
- **Categories:** Social media, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.99 / 1,000 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/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 Account Details Scraper: Extract Follower Counts, Bios, and Profile Data
The **Truth Social Account Details Scraper** is a no-code data extraction tool for **truthsocial.com**. Point it at any public Truth Social profile and it returns clean, structured JSON: follower counts, following counts, total statuses (posts), account creation dates, bios, avatars, header images, and verification status. No login required, no fragile CSS selectors, and no headless browser to babysit.
If you are tracking influential accounts on **truth social** or monitoring follower growth, you know that keeping an accurate historical record requires constant checks. This actor automates that for you, ensuring you capture exact, real-time profile metrics directly from the platform.
### What this Truth Social account scraper actually does
You give it a list of usernames (e.g. `realDonaldTrump`). It fetches the full public account profile for each one and writes it directly to your dataset.
You receive a complete, detailed account object that includes:
- Account ID, Username, and Display Name
- Bio (Note/Description)
- Follower count and Following count
- Total status (post) count
- Avatar and Header image URLs
- Verified and Premium status flags
- Account creation date
- Website and Location (if provided)
> **Looking for their actual posts?** If you need to scrape the statuses, replies, and media attachments of a Truth Social user, check out our companion actor: [Truth Social Scraper](https://apify.com/coder_luffy/truth-social-scraper).
### Why scraping truthsocial.com profile data is important
Most generic scrapers fail or get blocked when trying to scrape **truthsocial.com**. The site is dynamic, meaning a simple HTTP GET won't load the full follower numbers reliably without rendering JavaScript.
Using this actor, you bypass those issues entirely. You get the raw, complete JSON payload for the profile, which guarantees that your follower and following counts are exactly what the Truth Social database reports at that very second. It handles rate limiting, network retries, and pagination automatically.
### Use Cases for the Truth Social Account Scraper
> **🔬 Researchers & Academics**
> Monitor account growth and track the reach of political or influential figures over time by recording their follower counts and profile updates. Assemble large datasets for influence mapping.
> **📊 Social Media Analysts & Strategists**
> Build dashboards tracking the growth of specific accounts. Calculate engagement metrics by combining this exact follower size data with post interaction metrics.
> **🛡️ PR & Communications Teams**
> Keep tabs on when your clients or competitors update their bios, avatars, or website links on their Truth Social profiles. Know exactly when an account's messaging changes.
> **💾 Archivists & Data Engineers**
> Maintain a clean, structured database of account metadata to join against post/status datasets. Drop the JSON straight into your data warehouse.
[](https://apify.com/your-username/truth-social-account-details)
### Input parameters
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `profiles` | array | `["realDonaldTrump"]` | List of Truth Social usernames to look up. No `@` prefix needed. |
#### Example input
```json
{
"profiles": ["realDonaldTrump", "KariLake"]
}
````
### Output format
Each item in the dataset represents one complete account profile.
```json
{
"accountId": "107780257626128497",
"username": "realDonaldTrump",
"acct": "realDonaldTrump",
"display_name": "Donald J. Trump",
"locked": false,
"bot": false,
"discoverable": null,
"group": false,
"created_at": "2022-02-11T16:16:57.705Z",
"note": "",
"url": "https://truthsocial.com/@realDonaldTrump",
"avatar": "https://static-assets-1.truthsocial.com/.../454286ac07a6f6e6.jpeg",
"avatar_static": "https://static-assets-1.truthsocial.com/.../454286ac07a6f6e6.jpeg",
"header": "https://static-assets-1.truthsocial.com/.../ba3b910ba387bf4e.jpeg",
"header_static": "https://static-assets-1.truthsocial.com/.../ba3b910ba387bf4e.jpeg",
"followers_count": 12700600,
"following_count": 69,
"statuses_count": 33787,
"last_status_at": "2026-05-25",
"verified": true,
"location": "",
"website": "www.DonaldJTrump.com",
"accepting_messages": false,
"premium": true
}
```
### How to run it
Three options, use whichever fits your workflow.
Run it on the Apify platform with no code. Paste your usernames into the input form, hit start. Results land in the default dataset and you can export to JSON, CSV, or Excel from the UI.
Run it from Python. Install `apify-client`, drop in your API token, call `run` with the input dict, iterate the dataset. This is how you wire it into an existing data pipeline.
Run it from Node.js. Same idea on the JavaScript side: `npm install apify-client`, instantiate the client, call the actor, await the dataset.
### Legal and ethical notes
Public profiles on **truthsocial.com** are, by definition, public. Scraping them for research, journalism, archival, or analytics is generally fine. How you use that data is on you. Do not use it to harass individuals, build surveillance products targeting private citizens, or break Truth Social's terms in ways that will get you banned. If you are not sure whether your use case is acceptable, talk to a lawyer.
# Actor input Schema
## `profiles` (type: `array`):
List of Truth Social usernames to scrape account details for (e.g. realDonaldTrump).
## Actor input object example
```json
{
"profiles": [
"realDonaldTrump"
]
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"profiles": [
"realDonaldTrump"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("kawsar/truth-social").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "profiles": ["realDonaldTrump"] }
# Run the Actor and wait for it to finish
run = client.actor("kawsar/truth-social").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 '{
"profiles": [
"realDonaldTrump"
]
}' |
apify call kawsar/truth-social --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=kawsar/truth-social",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Truth Social Account Details (Live data)",
"description": "Extract full Truth Social profile data instantly. Get exact follower counts, following lists, account creation dates, bios, avatars, and verification status from any public Truth Social account. Export clean JSON for social media analytics, influence tracking, and PR monitoring",
"version": "0.0",
"x-build-id": "uk3kWV0JCGzhGsqvc"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/kawsar~truth-social/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-kawsar-truth-social",
"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/kawsar~truth-social/runs": {
"post": {
"operationId": "runs-sync-kawsar-truth-social",
"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/kawsar~truth-social/run-sync": {
"post": {
"operationId": "run-sync-kawsar-truth-social",
"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": [
"profiles"
],
"properties": {
"profiles": {
"title": "Profile Usernames",
"type": "array",
"description": "List of Truth Social usernames to scrape account details for (e.g. realDonaldTrump).",
"items": {
"type": "string"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```