{ "openapi": "3.0.1", "info": { "title": "Threads Crawler", "description": "One Actor for Threads profiles, tags, searches, posts with replies, and custom feeds. Supports bulk accounts, relative dates, engagement metrics, ISO timestamps, and media URLs. No login or API token required.", "version": "0.0", "x-build-id": "yi1YpbHr51LhwJrfV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zrkluke~threads-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zrkluke-threads-crawler", "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/zrkluke~threads-crawler/runs": { "post": { "operationId": "runs-sync-zrkluke-threads-crawler", "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/zrkluke~threads-crawler/run-sync": { "post": { "operationId": "run-sync-zrkluke-threads-crawler", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "profile", "tag", "search", "thread", "feed" ], "type": "string", "description": "Choose what kind of Threads page to crawl.", "default": "profile" }, "accounts": { "title": "Account list", "type": "array", "description": "Threads usernames to crawl. You can enter usernames with or without @.", "items": { "type": "string" } }, "bulkAccounts": { "title": "Bulk paste accounts", "type": "string", "description": "Paste up to 100 accounts, separated by new lines, commas, or spaces." }, "keywordsOrTags": { "title": "Keywords / tags", "type": "array", "description": "Keywords or tags for tag/topic and search modes. Enter tags with or without #.", "items": { "type": "string" } }, "bulkKeywordsOrTags": { "title": "Bulk paste keywords", "type": "string", "description": "Paste keywords or tags separated by new lines or commas." }, "searchSort": { "title": "Search sort", "enum": [ "top", "latest" ], "type": "string", "description": "Sorting preference for keyword search when Threads exposes it in the page.", "default": "top" }, "startDate": { "title": "Start date", "type": "string", "description": "Optional absolute start date. Applies best-effort filtering to visible relative timestamps." }, "endDate": { "title": "End date", "type": "string", "description": "Optional absolute end date. Applies best-effort filtering to visible relative timestamps." }, "relativeDate": { "title": "Relative date", "type": "string", "description": "Optional relative date window, for example: 7 days, 1 month, 24 hours." }, "threadUrls": { "title": "Thread URLs", "type": "array", "description": "Single post / thread URLs. Replies are extracted when publicly visible.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL", "description": "Threads post URL" } } } }, "feedUrls": { "title": "Custom feed URLs", "type": "array", "description": "Custom Threads feed URLs to crawl.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL", "description": "Threads feed URL" } } } }, "maxPostsPerAccount": { "title": "Max posts per account", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of posts to return per crawled account or target.", "default": 10 }, "includeRawText": { "title": "Include raw visible text", "type": "boolean", "description": "Store the full visible page text for debugging parser changes.", "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 } } } } } } } } } }