{ "openapi": "3.0.1", "info": { "title": "Threads Scraper - Extract Posts, Profiles & Engagement Data", "description": "Extract public posts, profiles, and engagement data from Threads by Meta. Scrape profile feeds, individual threads, images, videos, likes, and reply counts, no login required. Perfect for brand monitoring, influencer analytics, AI training data, and competitor research. Export to JSON, CSV, or Excel", "version": "0.1", "x-build-id": "a33LlxcRZXQ0Gp5cn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mellowed_headpiece~threads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mellowed_headpiece-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/mellowed_headpiece~threads-scraper/runs": { "post": { "operationId": "runs-sync-mellowed_headpiece-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/mellowed_headpiece~threads-scraper/run-sync": { "post": { "operationId": "run-sync-mellowed_headpiece-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": { "usernames": { "title": "Threads Usernames", "type": "array", "description": "Threads usernames (without @) to scrape. Each profile's posts will be extracted.", "items": { "type": "string" } }, "postUrls": { "title": "Individual Post URLs", "type": "array", "description": "Full URLs to specific Threads posts (e.g. https://www.threads.net/@zuck/post/C6Tt8xRRJXA). Leave empty if scraping entire profiles.", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "Max Posts Per Profile", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of posts to extract from each profile.", "default": 20 }, "searchKeywords": { "title": "Search Keywords", "type": "array", "description": "Search Threads by keyword — finds recent public posts matching each term. Combine with usernames or use standalone.", "items": { "type": "string" } }, "includeReplies": { "title": "Extract Reply Threads", "type": "boolean", "description": "For each scraped post, also extract all replies/comments. More data but slower runs.", "default": false }, "includeMediaInfo": { "title": "Include Media Metadata", "type": "boolean", "description": "Extract image and video URLs from posts.", "default": true }, "scrollTimeoutSecs": { "title": "Scroll Timeout (seconds)", "minimum": 10, "maximum": 120, "type": "integer", "description": "How long to keep scrolling for new posts.", "default": 30 }, "extractProfileMeta": { "title": "Extract Profile Metadata", "type": "boolean", "description": "Also extract profile info: bio, follower count, display name.", "default": true }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Use Apify proxy (recommended with RESIDENTIAL group) or your own.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }