{ "openapi": "3.0.1", "info": { "title": "Threads Search Scraper", "description": "Search public Threads posts by keyword and get post text, author, timestamp, like, reply, repost and quote counts and media URLs. Public search shows about 20-25 posts per keyword. Only-new mode remembers seen post IDs for monitoring. No Threads account or API key needed.", "version": "0.1", "x-build-id": "5XvhciXjvfaVJqIGm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~threads-keyword-search-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-threads-keyword-search-monitor", "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/axiomworks~threads-keyword-search-monitor/runs": { "post": { "operationId": "runs-sync-axiomworks-threads-keyword-search-monitor", "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/axiomworks~threads-keyword-search-monitor/run-sync": { "post": { "operationId": "run-sync-axiomworks-threads-keyword-search-monitor", "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": [ "queries" ], "properties": { "queries": { "title": "Keywords", "type": "array", "description": "Required. List of 1-100 keywords, phrases or #hashtags to search on public Threads, e.g. [\"apify\", \"#webscraping\", \"web scraping tools\"]. A threads.com search URL is also accepted. Each row carries its term in `query`. A term with no public posts returns 0 rows for it (run still succeeds).", "items": { "type": "string" } }, "maxItems": { "title": "Total item limit", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Optional overall cap on posts returned across all keywords, whole number 1-10000, e.g. 100. Stops the run once reached, even if maxItemsPerQuery allows more. Leave empty for no overall cap." }, "maxItemsPerQuery": { "title": "Items per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum posts per keyword, whole number 1-100, e.g. 20; default 50. Threads shows only ~20-25 top posts per term to logged-out visitors, so higher values return no more. Filters below apply after this limit.", "default": 50 }, "onlyNew": { "title": "Only new posts", "type": "boolean", "description": "Return only posts not seen before for each keyword in the monitor store, for scheduled runs; default false (first run returns all, later runs only new).", "default": false }, "monitorStoreName": { "title": "Monitor store", "type": "string", "description": "Name of the Apify key-value store that remembers up to 5000 seen post IDs per keyword, e.g. threads-keyword-monitor (letters, digits, hyphens; default threads-keyword-monitor).", "default": "threads-keyword-monitor" }, "maxAgeHours": { "title": "Maximum age", "minimum": 1, "maximum": 876000, "type": "integer", "description": "Exclude posts older than this number of hours, 1-876000; omit to include all available ages." }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Include posts marked as replies; default true.", "default": true }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Skip posts with fewer likes than this, 0 or more; default 0 (no filter).", "default": 0 }, "authorUsernames": { "title": "Only these authors", "type": "array", "description": "Keep only posts written by these Threads usernames, e.g. ['apify']; leading @ optional. Empty list means all authors.", "items": { "type": "string" }, "default": [] }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy for public Threads pages. Defaults to automatic datacenter proxy; the Actor falls back to US residential proxy only if Threads blocks the cheaper tier. Select RESIDENTIAL groups to use it from the start, or disable the proxy for direct requests.", "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 }, "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 } } } } } } } } } }