{ "openapi": "3.0.1", "info": { "title": "Threads Comments & Replies Scraper", "description": "Scrape every reply under Threads posts without login: newest first or top, replies to replies with the parent of each, author, likes, media, links and the post with exact views. Sentiment of each reply. Latest posts of profiles, Only new comments since the last run.", "version": "0.1", "x-build-id": "Ib9KX3beovExWngap" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~threads-replies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-threads-replies-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/s_actors~threads-replies-scraper/runs": { "post": { "operationId": "runs-sync-s_actors-threads-replies-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/s_actors~threads-replies-scraper/run-sync": { "post": { "operationId": "run-sync-s_actors-threads-replies-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": { "postUrls": { "title": "🔗 Threads post links", "type": "array", "description": "One per line: a link to a Threads post (https://www.threads.com/@user/post/CODE; threads.net links work too). Every reply under each post is scraped.", "items": { "type": "string" } }, "profiles": { "title": "👤 Profiles: replies on their latest posts", "type": "array", "description": "Optional: @username, a username or a profile link. The Actor takes the latest posts of each profile (pinned ones included) and scrapes their replies. Handy for monitoring the comments on your own or a competitor's account.", "items": { "type": "string" } }, "postsPerProfile": { "title": "📄 Latest posts per profile", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many of each profile's latest posts to take.", "default": 5 }, "maxRepliesPerPost": { "title": "💬 Max replies per post", "minimum": 0, "type": "integer", "description": "How many replies to scrape for each post, replies to replies included. 0 = all of them (thousands for viral posts).", "default": 100 }, "sortBy": { "title": "↕️ Order", "enum": [ "recent", "top" ], "type": "string", "description": "Newest first = every reply, from the latest back to the first one (complete exports and monitoring). Top first = the order Threads shows on the post page; Threads leaves out part of the low-ranked replies in this order (about half on viral posts).", "default": "recent" }, "includeNestedReplies": { "title": "↪️ Replies to replies", "type": "boolean", "description": "Also scrape the replies under each reply, at every level, with the parent reply of each row. Off = only the direct replies to the post (and the ones Threads shows right under them).", "default": true }, "analyzeSentiment": { "title": "😊 Sentiment (positive / neutral / negative)", "type": "boolean", "description": "Add sentiment and sentimentScore to every English reply and every reply of only emojis: positive, neutral or negative, and a score from -1 (most negative) to 1 (most positive), by the VADER rules made for social media text (slang, emojis, CAPS, \"!!!\", \"not good\", \"good but\"). Replies in other languages get an empty sentiment and are not charged. The status message and the POSTS summary show the share of each per post. Charged per labelled reply (see Pricing).", "default": false }, "onlyNewReplies": { "title": "🔔 Only new replies since the previous run", "type": "boolean", "description": "Output only replies that no earlier run delivered for the same post (key-value store threads-replies-state). With Newest first the Actor stops paging at the previous run's newest reply. The first run outputs replies as usual and remembers them. A run with no new replies costs only the start.", "default": false }, "maxConcurrency": { "title": "⚡ Posts at the same time", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many posts are read in parallel. Each post pages its replies on its own (about 45 replies a request).", "default": 3 }, "proxyConfiguration": { "title": "🛡️ Proxy", "type": "object", "description": "Requests go direct first and switch to Apify datacenter proxies (then residential) when Threads refuses them. The default works for most runs.", "default": { "useApifyProxy": true } }, "debugLog": { "title": "🐞 Debug log", "type": "boolean", "description": "Log every retried request (for troubleshooting).", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }