{ "openapi": "3.0.1", "info": { "title": "Threads (Meta) Scraper — Posts, Profiles & Replies", "description": "Scrape Meta Threads profiles and posts. Extract text, likes, replies, reposts, images, follower counts, and engagement data. Supports profile URLs, search terms, and thread detail pages with reply chains. Pay per post scraped.", "version": "1.0", "x-build-id": "QcQTcg17hhPmCbLCS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sovereigntaylor~threads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sovereigntaylor-threads-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/sovereigntaylor~threads-scraper/runs": { "post": { "operationId": "runs-sync-sovereigntaylor-threads-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/sovereigntaylor~threads-scraper/run-sync": { "post": { "operationId": "run-sync-sovereigntaylor-threads-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": { "profileUrls": { "title": "Profile URLs", "type": "array", "description": "List of Threads profile URLs to scrape. Accepts full URLs (https://www.threads.net/@username) or just the username (with or without @). Example: [\"https://www.threads.net/@zuck\", \"@mosseri\", \"instagram\"]", "default": [ "https://www.example.com" ], "items": { "type": "string" } }, "searchTerms": { "title": "Search Terms", "type": "array", "description": "Search terms to discover Threads posts and profiles via Google. The scraper uses 'site:threads.net' + your term. Examples: 'AI artificial intelligence', 'startup funding', 'product launch'. Each term generates a separate search.", "default": [ "coffee shop" ], "items": { "type": "string" } }, "threadUrls": { "title": "Thread URLs", "type": "array", "description": "Direct URLs to individual thread posts. Scrapes the post content plus its reply chain. Example: [\"https://www.threads.net/@zuck/post/C1234567890\"]", "default": [], "items": { "type": "string" } }, "maxPosts": { "title": "Max Posts", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of posts to scrape per profile or search term. Set lower for testing, higher for comprehensive data collection.", "default": 10 }, "includeReplies": { "title": "Include Replies", "type": "boolean", "description": "Whether to scrape reply threads under each post. Enables deeper conversation analysis but increases scraping time and cost.", "default": false }, "includeReposts": { "title": "Include Reposts", "type": "boolean", "description": "Whether to include reposts (shares) in the output. Disable to get only original content.", "default": true }, "maxRepliesPerPost": { "title": "Max Replies Per Post", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of replies to scrape per thread when includeReplies is enabled.", "default": 10 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum number of concurrent requests. Keep low (1-3) to avoid blocks. Threads inherits Meta's aggressive anti-bot measures.", "default": 2 }, "requestDelay": { "title": "Request Delay (seconds)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Minimum delay between requests in seconds. Higher values reduce chance of being blocked but slow down scraping. Recommended: 3-10 seconds for Threads.", "default": 4 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration. STRONGLY RECOMMENDED — Threads/Meta blocks datacenter IPs aggressively. Use residential proxies for best results.", "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 } } }, "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 } } } } } } } } } }