{ "openapi": "3.0.1", "info": { "title": "Threads Scraper - Scrape threads.net Posts, No Login", "description": "No-login Threads scraper & unofficial API alternative. Export public Threads posts, replies, profiles & engagement to CSV, JSON or Excel.", "version": "1.0", "x-build-id": "5kIgcIgLP2MoR2O0j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~threads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-threads-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/logiover~threads-scraper/runs": { "post": { "operationId": "runs-sync-logiover-threads-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/logiover~threads-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-threads-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": { "usernames": { "title": "Threads usernames", "type": "array", "description": "Threads @handles or profile URLs to scrape posts from. Examples: 'zuck', '@mosseri', 'https://www.threads.com/@natgeo'.", "items": { "type": "string" } }, "postUrls": { "title": "Post URLs", "type": "array", "description": "Specific Threads post URLs to scrape (the post plus its visible reply thread). Example: 'https://www.threads.com/@zuck/post/DY11ZLWG_eY'.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms / tags", "type": "array", "description": "Keywords or #tags to search public Threads posts for. Examples: 'ai', '#travel', 'startup'.", "items": { "type": "string" } }, "maxResults": { "title": "Max results per target", "minimum": 0, "type": "integer", "description": "Maximum posts to collect per target (timeline + expanded reply threads). 0 = unlimited (recommended for max volume). With reply expansion on, a single profile can yield several hundred posts.", "default": 0 }, "includeReplies": { "title": "Include reply threads (expand)", "type": "boolean", "description": "Open each target post's page to also collect its reply thread (~25-30 posts each). This is the main volume multiplier — it turns a ~26-post profile into several hundred posts. Uses cheap HTTP fetches, no extra browser.", "default": true }, "expandFromProfiles": { "title": "Expand profile posts", "type": "boolean", "description": "When 'Include reply threads' is on, also expand the reply thread of each post collected from a profile timeline.", "default": true }, "expandFromSearch": { "title": "Expand search posts", "type": "boolean", "description": "When 'Include reply threads' is on, also expand the reply thread of each post returned by a search term / tag. Off by default (search posts come from many authors).", "default": false }, "maxExpandPerTarget": { "title": "Max posts to expand per target", "minimum": 0, "type": "integer", "description": "How many of a target's own posts to open for reply expansion. Higher = more rows but more HTTP requests. Default 30 covers a full profile timeline.", "default": 30 }, "maxRepliesPerPost": { "title": "Max replies kept per post", "minimum": 0, "type": "integer", "description": "Cap on how many reply posts to keep from each expanded post page. Default 50.", "default": 50 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "A proxy is required — Threads serves an interstitial to direct requests. The datacenter default is enough and returns the same posts as residential, slightly faster. Only switch to the RESIDENTIAL group if you start seeing empty results.", "default": { "useApifyProxy": true, "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }