{ "openapi": "3.0.1", "info": { "title": "Threads Profile Scraper โ€” Followers, Bio Links, Recent Posts", "description": "Bulk-scrape public Threads (threads.com) profiles by username or URL: follower count, full name, bio, every bio link, verified and private flags, topic tags, plus the 4-10 most recent posts with likes, replies and reposts โ€” and a computed recent engagement rate. $2.00 per 1,000 profiles. No login.", "version": "0.1", "x-build-id": "DK9KD6tu0oO2vXpbL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~threads-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-threads-profile-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/scrapersdelight~threads-profile-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-threads-profile-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/scrapersdelight~threads-profile-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-threads-profile-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": { "profiles": { "title": "๐Ÿงต Profiles โ€” username or URL", "uniqueItems": true, "type": "array", "description": "One profile per line. Accepts a bare username (`zuck`), an `@handle` (`@natgeo`), or a full profile URL (`https://www.threads.com/@openai`, `threads.net/@mosseri` โ€” both domains work). You are billed per profile **returned**, so this list is also your cost ceiling: 1,000 profiles = $2.00. Duplicate entries collapse to one billed row.\n\nLeave this **and** the URL list empty and the Actor runs a 3-profile demo sample (`zuck`, `natgeo`, `openai`, $0.006) instead of failing, so an API or agent call with no input still gets real rows back.", "items": { "type": "string" } }, "startUrls": { "title": "๐Ÿ“„ Profile URL list โ€” bulk paste, file or Google Sheet", "type": "array", "description": "The bulk path: paste many profile URLs at once, upload a .txt/.csv of them, or link a Google Sheet. Entries must be full Threads URLs (`https://www.threads.com/@handle`) โ€” a bare username inside a file is ignored, because a CSV column of names cannot be told apart from data. Merged with the field above and de-duplicated. Reading the list is free; you are billed only for profiles returned.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includePosts": { "title": "Include recent posts", "type": "boolean", "description": "Keep this on to get the `recent_posts` array (4-10 posts: text, timestamp, likes, replies, reposts, quotes, media URLs, post URL) and the derived `recent_avg_likes` / `recent_engagement_rate` fields. Turn it off for a slimmer, profile-only row โ€” the price per profile is the same either way, because it is the same single page request.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Start with the default. Threads intermittently answers a logged-out request with its log-in interstitial instead of the profile; the Actor clears that by retrying on a fresh proxy session (measured: 29 of 29 profiles readable within 3 attempts through Apify datacenter proxies) and, if a profile still will not load, retries it through RESIDENTIAL โ€” capped at max(3, 20% of your list) per run so the fallback stays bounded. You normally never need to touch this field.", "default": { "useApifyProxy": true } }, "requestConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many profiles to fetch at once. The default of 4 is what the measured retry numbers were taken at. Raising it shortens the run but gives Threads more reason to serve the log-in interstitial, which costs you retries โ€” not money.", "default": 4 }, "requestDelayMs": { "title": "Delay between profiles (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Pacing per worker, applied after each profile. 0 is allowed and is faster; 500 ms is the measured default.", "default": 500 } } }, "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 } } } } } } } } } }