{ "openapi": "3.0.1", "info": { "title": "Truth Social Scraper - Posts, Profiles, Monitor (no login)", "description": "Truth social scraper for public accounts: one flat row per post with text, media, replies, reposts and likes, plus an optional profile row with followers and post counts. No login, no API token. Monitor mode alerts on new posts and engagement changes. $2 per 1,000 rows, empty runs cost nothing.", "version": "0.1", "x-build-id": "lwgWWm1HcH3TpZLzk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~truth-social-posts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-truth-social-posts", "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/datahamster~truth-social-posts/runs": { "post": { "operationId": "runs-sync-datahamster-truth-social-posts", "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/datahamster~truth-social-posts/run-sync": { "post": { "operationId": "run-sync-datahamster-truth-social-posts", "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", "properties": { "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many results (you are charged only for pushed items)", "default": 100 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "scrape = full results; monitor = only new/changed items since the previous run of this task", "default": "scrape" }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Optional state key when not running as a saved task" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST a change summary here in monitor mode" }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional: bot token for monitor-mode change summaries" }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional: chat id that receives monitor-mode summaries" }, "accounts": { "title": "Accounts", "type": "array", "description": "Public Truth Social accounts to scrape, one per line. A handle (\"realDonaldTrump\"), an @handle (\"@TeamTrump\") or a profile URL (\"https://truthsocial.com/@TeamTrump\") all work.", "default": [ "realDonaldTrump" ], "items": { "type": "string" } }, "maxPostsPerAccount": { "title": "Max posts per account", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many posts to take from each account, newest first, e.g. 100. The overall run still stops at Max items, and each account reads at most 300 pages (6,000 statuses) however tight the filters are. Range 1-5000.", "default": 100 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "true = keep the account's replies to other posts as rows (`isReply: true`). false = only the account's own posts. Filtering costs extra: replies and reposts are dropped after they are fetched, so a filtered run reads more pages (more billed Web Unblocker requests) than the number of rows you keep. Example: false.", "default": false }, "includeReposts": { "title": "Include reposts", "type": "boolean", "description": "true = keep reposts (ReTruths) as rows carrying the original post's text, media and counters plus `repostOfUsername`. false = only original posts. Like Include replies, filtering drops rows after fetching them, so a filtered run reads more pages and bills more Web Unblocker requests than the rows kept. Example: false.", "default": false }, "sinceDate": { "title": "Only posts since", "type": "string", "description": "Stop at the first post older than this date, e.g. \"2026-09-01\" or \"2026-09-01T12:00:00Z\". Leave empty to go back as far as Max posts per account allows." }, "includeAccountRow": { "title": "Add a profile row", "type": "boolean", "description": "true = emit one extra row per account (`kind: \"account\"`) with followers, following, post count, bio, website and verification. false = posts only. Example: true.", "default": false } } }, "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 } } } } } } } } } }