{ "openapi": "3.0.1", "info": { "title": "Truth Social Scraper", "description": "Scrape profile info, truths and replies from the Truth social media platform.", "version": "0.0", "x-build-id": "AkgWSH6C94wawqEEL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tri_angle~truth-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tri_angle-truth-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/tri_angle~truth-scraper/runs": { "post": { "operationId": "runs-sync-tri_angle-truth-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/tri_angle~truth-scraper/run-sync": { "post": { "operationId": "run-sync-tri_angle-truth-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": "Truth profile(s)", "type": "array", "description": "Enter username(s) with or without \"@\". Additionally you can provide profile URL(s) (e.g. https://truthsocial.com/@realDonaldTrump).", "items": { "type": "string" } }, "resultsType": { "title": "Content to scrape", "enum": [ "profile-details", "posts", "replies", "posts-and-replies" ], "type": "string", "description": "Type of content you want to scrape from the specified profiles:\n- **Profile details**: Scrape information about the profile itself, such as the description, avatar, followersCount and other profile-related details.\n- **Posts**: Scrape the posts made by the profile, excluding replies to other posts.\n- **Replies**: Scrape only the replies that the profile has made to other users posts.\n- **Posts and replies**: Scrape both the main posts made by the profile and the replies to other users posts.", "default": "profile-details" }, "maxPostsAndReplies": { "title": "Max posts/replies per profile", "minimum": 0, "type": "integer", "description": "The maximum number of posts/replies to scrape per profile.", "default": 100 }, "includeMuted": { "title": "Include muted posts/replies", "type": "boolean", "description": "If checked, muted posts/replies will also be included in the `postsAndReplies` output.", "default": true }, "continueFromLastPostId": { "title": "Continue from last post id", "type": "boolean", "description": "If checked, on each run only posts/replies newer than the last id seen for each profile/resultsType pair will be scraped. The newest id per `username:resultsType` is persisted to the named key-value store `store-truth-cursor` under key `LAST_POST_IDS`, so the cursor carries across runs. Useful for incremental runs.", "default": false }, "peek": { "title": "Peek (don't persist cursor)", "type": "boolean", "description": "Only relevant when `continueFromLastPostId` is on. If checked, the run still uses the persisted cursor to filter results, but does NOT update the cursor at the end. Use this for cheap \"is there at least one new post since last run?\" probes: set `maxPostsAndReplies` to 1 and `peek` to true, then trigger a follow-up run with `peek` off (and a higher `maxPostsAndReplies`) to fetch every new post since the previous real run.", "default": false }, "postsNewerThan": { "title": "Only posts/replies newer than (ISO date)", "type": "string", "description": "ISO 8601 date or date-time (e.g. `2026-04-01` or `2026-04-01T00:00:00Z`). Only posts/replies with `createdAt` strictly newer than this value are returned. Pagination stops as soon as an older non-pinned post is encountered, so the filter is efficient on Truth Social's newest-first feed. Useful for ad-hoc backfills (`continueFromLastPostId` handles the recurring case). Leave empty to disable." }, "onlyPostsWithMedia": { "title": "Only posts/replies with media", "type": "boolean", "description": "If checked, only posts/replies that contain at least one media attachment (image, video, GIF) will be returned.", "default": false }, "cleanContent": { "title": "Clean content (strip HTML)", "type": "boolean", "description": "If checked, HTML tags are stripped from the `content` field and common HTML entities are decoded. Truth Social wraps post text in `

`, ``, `
` etc. - turn this on to get plain text. Defaults to false to preserve the existing output shape.", "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 } } } } } } } } } }