{ "openapi": "3.0.1", "info": { "title": "Threads Search & Profile Posts Scraper | No Login", "description": "Search public Threads posts with literal word, phrase or hashtag matching, or download posts from profiles. Filter by author and dates. Export text, links, engagement and media. No login or cookies required.", "version": "0.0", "x-build-id": "h9MUXt2yCibPM3suH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraping_solutions~threads-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraping_solutions-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/scraping_solutions~threads-search-scraper/runs": { "post": { "operationId": "runs-sync-scraping_solutions-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/scraping_solutions~threads-search-scraper/run-sync": { "post": { "operationId": "run-sync-scraping_solutions-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", "properties": { "mode": { "title": "Download mode", "enum": [ "keyword", "profile" ], "type": "string", "description": "Keyword searches public posts. Profile downloads available public posts from the supplied profiles. Use one mode per run.", "default": "keyword" }, "keywords": { "title": "Keywords, exact phrases or hashtags", "minItems": 1, "maxItems": 100, "type": "array", "description": "Required in keyword mode: 1-100 entries, each 1-500 characters. A post is saved only when its text contains the complete word, phrase or hashtag. Matching ignores case; AI does not match inside daily. This is not a Boolean parser. Do not also supply usernames.", "items": { "type": "string" } }, "usernames": { "title": "Threads profiles", "minItems": 1, "maxItems": 100, "type": "array", "description": "Required in profile mode: 1-100 usernames, @usernames or Threads profile URLs. Remove keywords when switching to this mode. Invalid entries are reported by index.", "items": { "type": "string" } }, "maxResultsPerInput": { "title": "Maximum posts per keyword or profile", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum unique posts attributed to each input, from 0 to 100,000. 0 requests all available within budget and internal safeguards. Posts found under multiple inputs are saved and charged once, under the first matching input. Free quota can reduce the limit.", "default": 100 }, "sort": { "title": "Keyword search order", "enum": [ "top", "recent" ], "type": "string", "description": "Search order in keyword mode. Top is the recommended default because it generally returns more unique matches per request, but its ranking is service-defined and is not guaranteed to sort by likes. This setting is ignored in profile mode.", "default": "top" }, "fromUsername": { "title": "Keyword search: author", "type": "string", "description": "Optional Threads username or profile URL to restrict keyword searches to one author. Returned author usernames are checked for an exact, case-insensitive match before saving or charging. Posts from other or unidentified authors are discarded; counts appear in OUTPUT. Leave empty for profile mode.", "default": "" }, "oldestPostDate": { "title": "Keyword search: oldest date", "type": "string", "description": "Optional inclusive YYYY-MM-DD lower boundary in UTC. Returned posts are checked locally before saving or charging. Leave empty for profile mode.", "default": "" }, "newestPostDate": { "title": "Keyword search: newest date", "type": "string", "description": "Optional inclusive YYYY-MM-DD upper boundary in UTC. Must not precede the oldest date. Returned posts are checked locally before saving or charging. Leave empty for profile mode.", "default": "" } } }, "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 } } } } } } } } } }