{ "openapi": "3.0.1", "info": { "title": "Threads User Posts Scraper With Creator Contact Leads", "description": "Threads User Posts Scraper With Creator Contact Leads extracts Threads posts, creator profiles, bios, emails, social links, usernames, captions, hashtags, engagement metrics, and timestamps. Ideal for lead generation, creator outreach, audience research, and competitor analysis.", "version": "0.1", "x-build-id": "0JrnK5llD14VnX5AU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~threads-user-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-threads-user-posts-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/scrapio~threads-user-posts-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-threads-user-posts-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/scrapio~threads-user-posts-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-threads-user-posts-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": "๐ŸŽฏ Creator profiles (URLs or @handles)", "type": "array", "description": "๐Ÿงต The Threads creators to collect from. Paste profile links (`threads.com` / `threads.net`) or plain @handles โ€” one per line, bulk lists welcome. Example: `https://www.threads.com/@zuck` or just `zuck`.", "items": { "type": "string" } }, "postsPerCreator": { "title": "๐Ÿ”ข Posts per creator", "minimum": 1, "maximum": 5000, "type": "integer", "description": "๐Ÿ“Š How many recent posts to save for each creator (1โ€“5000). Example: `postsPerCreator=10` saves the 10 latest posts per handle. Lower = faster; higher = deeper history. Default is 10.", "default": 10 }, "extractCreatorContacts": { "title": "๐Ÿชช Extract creator contact block", "type": "boolean", "description": "๐Ÿ“‡ Add a per-creator contact block to every post row โ€” bio email, phone and website (parsed from the public bio), plus follower count, full name and the verified badge. One extra lightweight profile lookup per creator. Turn off to return posts only. Default is on.", "default": true }, "contactsOnly": { "title": "โœ… Only creators with a contact", "type": "boolean", "description": "๐Ÿงน When on, skip creators whose public bio has no email, phone or website โ€” so the output is a clean contactable-lead list. When off, every creator's posts are kept. Enabling this turns on contact extraction automatically. Default is off.", "default": false }, "proxyConfiguration": { "title": "๐ŸŒ Apify proxy (backup only)", "type": "object", "description": "๐Ÿ”ง Optional. The actor talks to Threads directly first and auto-escalates to Apify Datacenter, then Residential, if traffic is blocked. Expand only to force a specific group/country/session. Leaving Use Apify Proxy = Off is the recommended default." } } }, "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 } } } } } } } } } }