{ "openapi": "3.0.1", "info": { "title": "Truth Social Scraper: Posts & Profiles", "description": "Scrape Truth Social posts and profiles without a login. Paste usernames or post URLs and get every post with likes, reblogs, replies, upvotes and downvotes, edits, media, quotes and link cards, plus full profile details. Filter by date, skip replies or reblogs. Export to CSV, Excel or JSON.", "version": "0.1", "x-build-id": "jpWuNTBdAkb93dqMo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sz022~truth-social-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sz022-truth-social-posts-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/sz022~truth-social-posts-scraper/runs": { "post": { "operationId": "runs-sync-sz022-truth-social-posts-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/sz022~truth-social-posts-scraper/run-sync": { "post": { "operationId": "run-sync-sz022-truth-social-posts-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", "properties": { "profiles": { "title": "Profiles", "maxItems": 5000, "type": "array", "description": "Truth Social usernames or profile URLs, one per line: realDonaldTrump, @realDonaldTrump or https://truthsocial.com/@realDonaldTrump. Each gives one profile row and up to the maximum number of posts below. A post URL pasted here is read as a post.", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "Maximum posts per profile", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Newest first. Set to 0 to get only the profile rows. Each post row is charged, so this also caps what a profile can cost.", "default": 20 }, "postsSince": { "title": "Posts from", "type": "string", "description": "Optional. Only posts created on or after this date (UTC). A date such as 2026-10-01, or a relative one such as 7 days. Reading stops at the first older post, so an early date never costs more requests than it needs." }, "postsUntil": { "title": "Posts until", "type": "string", "description": "Optional. Only posts created on or before this date (UTC; a bare date includes that whole day). The feed is opened at this date, so older periods are reached without paging through newer posts." }, "excludeReplies": { "title": "Skip replies", "type": "boolean", "description": "Leave out posts that reply to another post, the account's own threads included.", "default": false }, "excludeReblogs": { "title": "Skip reblogs (ReTruths)", "type": "boolean", "description": "Leave out posts the account only reshared. Quote posts, which add the account's own text, are kept.", "default": false }, "onlyPostsWithMedia": { "title": "Only posts with images or video", "type": "boolean", "description": "Keep only posts that carry at least one image, video or other attachment.", "default": false }, "postUrls": { "title": "Post URLs", "maxItems": 10000, "type": "array", "description": "Single posts, one per line: https://truthsocial.com/@realDonaldTrump/117461843705117717, the /posts/ form, or just the numeric post ID. Each gives one post row. A post already returned from a profile's feed in the same run is not repeated or charged twice.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify's datacenter proxy by default. If Cloudflare blocks it, the run moves to Apify's US residential proxy on its own (see the option below). Proxy URLs of your own are used as given.", "default": { "useApifyProxy": true } }, "residentialFallback": { "title": "Switch to residential proxy if blocked", "type": "boolean", "description": "When Cloudflare keeps blocking the datacenter proxy, read the rest of the run through Apify's US residential proxy. The residential traffic is included in the per-row price. Turn off to fail fast instead.", "default": true } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }