{ "openapi": "3.0.1", "info": { "title": "Threads Search Post Scraper By Profile & Keyword", "description": "Threads Search Post Scraper: Find posts by profile and keyword, capturing post text, authors, timestamps, URLs, replies, likes, reposts, and available engagement data. Analyze relevant conversations, content trends, audience interests, and competitor activity for social media research.", "version": "0.1", "x-build-id": "Syk6AIV2lalHWA9Sl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~threads-search-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-threads-search-post-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/api-empire~threads-search-post-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-threads-search-post-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/api-empire~threads-search-post-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-threads-search-post-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": { "urls": { "title": "๐Ÿ”— Targets (post URL, post ID, or search phrase)", "type": "array", "description": "Each line: a full post URL (threads.com or threads.net), a numeric post ID (10+ digits), or a search phrase. A search phrase now returns EVERY matching post it can find (not just one). Example URL: https://www.threads.com/@zuck/post/AbCdEfGhIjK โ€” example phrase: Mark Zuckerberg", "items": { "type": "string" } }, "maxItems": { "title": "๐Ÿ”ข Max items (whole run)", "minimum": 0, "type": "integer", "description": "Cap on how many post rows to save across the whole run (targets + profiles combined). Leave empty (or 0) for no limit. Per-profile summary rows don't count against this cap." }, "profiles": { "title": "๐Ÿงต Profiles to discover", "type": "array", "description": "One or more Threads usernames or profile URLs. Each is expanded into that account's own paginated post history โ€” a coverage mode the base targets list doesn't have. Example: zuck or https://www.threads.com/@zuck", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "๐Ÿ“ˆ Max posts per profile", "minimum": 0, "type": "integer", "description": "Cap on how many posts to pull from EACH profile in the list above. Example: maxPostsPerProfile=20 with 3 profiles -> up to 60 profile post rows (still bounded by Max items). Default is 20." }, "includeProfileRollup": { "title": "๐Ÿ“Š Include per-profile roll-up row", "type": "boolean", "description": "When on, after each profile's posts are collected an extra summary row is added: average likes / replies / reposts / quotes, the top post, and posting cadence (posts per day). Off = only individual post rows.", "default": true }, "proxyConfiguration": { "title": "๐ŸŒ Proxy (optional)", "type": "object", "description": "Leave off for a simple run. Turn on Apify Proxy here when you want Apify to route requests through its network โ€” useful on busy or sensitive targets." } } }, "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 } } } } } } } } } }