{ "openapi": "3.0.1", "info": { "title": "Threads Search Scraper: Keywords & Hashtags, No Login", "description": "Search Threads by keyword or hashtag without login. Get posts with text, author, likes, replies, reposts, quotes, media, hashtags and mentions as JSON, CSV or Excel. Date and engagement filters. $2 per 1,000 posts.", "version": "0.1", "x-build-id": "dm8ngryStwQxYteQE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrape-lads~threads-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrape-lads-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/scrape-lads~threads-search-scraper/runs": { "post": { "operationId": "runs-sync-scrape-lads-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/scrape-lads~threads-search-scraper/run-sync": { "post": { "operationId": "run-sync-scrape-lads-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": "Keywords or hashtags", "type": "array", "description": "Words, phrases or #hashtags to search on Threads, one per line. A pasted Threads search URL (threads.com/search?q=...) also works.", "items": { "type": "string" } }, "searchMode": { "title": "Sort", "enum": [ "top", "recent" ], "type": "string", "description": "Top keeps Threads' own ranking, starting with the most engaged posts. Recent starts with Threads' fresh results and sorts each search newest first.", "default": "top" }, "maxPostsPerQuery": { "title": "Max posts per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop a search once this many posts pass your filters. Threads shows a logged-out visitor about 30 to 70 distinct posts per search, so values above 100 rarely add more.", "default": 50 }, "maxPosts": { "title": "Max posts per run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total cap across all searches. The run stops when it is reached.", "default": 1000 }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Keep only posts published on or after this date. YYYY-MM-DD (UTC), an ISO timestamp, or a relative value such as \"7 days\" or \"12 hours\". Posts outside the range are not charged." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Keep only posts published on or before this date (a bare date includes that whole day). Same formats as Posted after." }, "requireKeywordInText": { "title": "Only posts that contain the keyword", "type": "boolean", "description": "Threads also returns related posts that do not contain your words. Turn this on to keep only posts whose text contains every search word (or the hashtag). Dropped posts are not charged.", "default": false }, "excludeReplies": { "title": "Exclude replies", "type": "boolean", "description": "Skip posts that are replies to another post.", "default": false }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Skip posts with fewer likes than this.", "default": 0 }, "includeAuthorDetails": { "title": "Add author follower count and bio", "type": "boolean", "description": "Open each unique author's profile to add their follower count and bio. Charged once per unique author (see Pricing) and makes the run slower.", "default": false }, "dedupeAcrossQueries": { "title": "Remove duplicates across searches", "type": "boolean", "description": "When two searches find the same post, keep it only once (under the first search).", "default": true }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at the same time.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy used to reach Threads. The default works for most runs.", "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 } } } } } } } } } }