{ "openapi": "3.0.1", "info": { "title": "Threads Search - Keyword & Profile Posts Scraper (No Login)", "description": "Find public Threads posts by keyword, hashtag or topic (top, recent and tag results) and collect the posts and replies of any Threads profile. Each row has the text, author, likes, replies, reposts, quotes, media URLs and post date. No login or cookies. $2.50 per 1,000 posts; failed inputs are free.", "version": "1.0", "x-build-id": "XUXSxA55GEKn0n04z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~threads-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-threads-search", "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/tenfoldfleet~threads-search/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-threads-search", "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/tenfoldfleet~threads-search/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-threads-search", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Words, brand names, phrases or #hashtags to search on Threads. Each keyword returns up to about 40 public posts (Threads shows logged-out visitors a limited number per search), so add several related keywords to cover a topic.", "items": { "type": "string" } }, "searchTypes": { "title": "Search tabs", "type": "array", "description": "Which Threads search results to collect for each keyword: \"top\" (most relevant), \"recent\" (newest first) and \"tags\" (posts in matching topic tags). Posts found in more than one tab are returned once.", "items": { "type": "string", "enum": [ "top", "recent", "tags" ], "enumTitles": [ "Top", "Recent", "Topic tags" ] }, "default": [ "top", "recent", "tags" ] }, "usernames": { "title": "Profiles", "type": "array", "description": "Threads profiles to collect posts from: @handles (\"@nasa\"), bare handles (\"nasa\") or profile links (\"https://www.threads.com/@nasa\"). Unknown or unavailable profiles are reported as a free error row.", "items": { "type": "string" } }, "includeReplies": { "title": "Include the profile's replies", "type": "boolean", "description": "Also collect the replies each profile wrote under other people's posts (the profile's Replies tab), each with the post it answers. Counted separately from the profile's own posts.", "default": false }, "includeProfile": { "title": "Include a profile row", "type": "boolean", "description": "Add one row per profile with name, bio, follower count, verified badge, profile picture and bio links.", "default": true }, "maxPostsPerInput": { "title": "Max posts per keyword or profile", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Upper limit of posts for each keyword, and for each profile's posts (and again for its replies). Keyword searches usually stop at about 30-40 posts because that is all Threads shows without login; profiles page further back (a few hundred posts). Set 0 with \"Include a profile row\" on to get only profile rows. Free Apify plan: at most 50 results per run.", "default": 40 }, "maxConcurrency": { "title": "Parallel inputs", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many keywords or profiles are scraped at the same time.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is used by default and is included in the price. Residential proxy groups are ignored.", "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 } } } } } } } } } }