{ "openapi": "3.0.1", "info": { "title": "Threads Search Scraper", "description": "Search Threads by keyword or hashtag without logging in and get the matching posts as structured data: text, author, likes, replies, reposts, quotes, media URLs and links, as JSON, CSV or Excel.", "version": "1.0", "x-build-id": "Q90OJjNIexoUXidHp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logical_scrapers~threads-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logical_scrapers-threads-search-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/logical_scrapers~threads-search-scraper/runs": { "post": { "operationId": "runs-sync-logical_scrapers-threads-search-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/logical_scrapers~threads-search-scraper/run-sync": { "post": { "operationId": "run-sync-logical_scrapers-threads-search-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords, phrases, hashtags (with or without #) or Threads search URLs (https://www.threads.com/search?q=...). Each query is searched separately.", "items": { "type": "string" } }, "searchType": { "title": "Search type", "enum": [ "top", "recent", "tags", "all" ], "type": "string", "description": "Which Threads search tab to read. Top returns the posts Threads ranks highest, Recent the newest posts, Tags the posts filed under the matching topic tag. All reads the three tabs in that order and removes duplicates, which returns the most posts per query.", "default": "top" }, "maxItems": { "title": "Max posts per query", "minimum": 1, "type": "integer", "description": "Maximum number of posts to save per search query. Threads shows a logged-out visitor one page per search tab, so a single tab returns roughly 15 to 35 posts; use the All search type to get more.", "default": 20 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Search results sometimes carry a reply underneath the matching post. Turn this on to save those replies as their own items; off saves only the top-level posts.", "default": false }, "postedAfter": { "title": "Posted after", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep only posts published on or after this date (YYYY-MM-DD, UTC). Applied to the posts Threads returns; it does not make Threads search further back." }, "postedBefore": { "title": "Posted before", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep only posts published before this date (YYYY-MM-DD, UTC)." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for Threads requests. Apify datacenter proxies are enough; Threads rate limits a single IP after many searches, so the Actor rotates sessions automatically.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }