{ "openapi": "3.0.1", "info": { "title": "Threads Scraper: Profiles, Posts, Replies & Search", "description": "Scrape Threads profiles, posts, replies and keyword search: followers, bio, post text, likes, replies, reposts, quotes, media and links. No login. Monitoring returns only new posts.", "version": "0.1", "x-build-id": "09MiqEDjVUFnihFMi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stratumics~threads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stratumics-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/stratumics~threads-scraper/runs": { "post": { "operationId": "runs-sync-stratumics-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/stratumics~threads-scraper/run-sync": { "post": { "operationId": "run-sync-stratumics-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": { "profiles": { "title": "Profiles", "type": "array", "description": "Threads usernames (@nasa or nasa) or profile links (https://www.threads.com/@nasa), one per line. Each gives a profile row and the profile's latest posts.", "items": { "type": "string" } }, "posts": { "title": "Post links", "type": "array", "description": "Links to single Threads posts (https://www.threads.com/@user/post/...), one per line. Each gives one post row, and its replies when replies are on.", "default": [], "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search on Threads, one per line. Threads shows signed-out visitors about 20 results per search, so each term gives up to that many posts.", "default": [], "items": { "type": "string" } }, "searchSort": { "title": "Search results", "enum": [ "recent", "top" ], "type": "string", "description": "Recent: the newest posts for the term. Top: the posts Threads ranks highest.", "default": "recent" }, "maxPostsPerProfile": { "title": "Max posts per profile or search", "minimum": 0, "maximum": 5000, "type": "integer", "description": "The most posts to save from each profile, newest first (pinned posts come first, as on the profile), and from each search term. Set 0 for profile rows only. Threads limits how many pages one run can read while signed out (about 1,700 posts in all in testing); profiles reached after that get the posts on their profile page.", "default": 20 }, "includeProfileRows": { "title": "Save a profile row per profile", "type": "boolean", "description": "Save one row per profile with followers, bio, bio links, verified badge and picture. Turn it off when you only want posts, for example in a monitoring schedule. Private and missing profiles always get a free status row.", "default": true }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also save the replies under each post, each as a row of its own with the post it answers. Threads shows signed-out visitors about ten replies per post. Replies are charged separately.", "default": false }, "maxRepliesPerPost": { "title": "Max replies per post", "minimum": 1, "maximum": 200, "type": "integer", "description": "The most replies to save under each post when replies are on.", "default": 20 }, "newerThan": { "title": "Only posts newer than", "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?(Z|[+-][0-2]\\d:?[0-5]\\d)?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$", "type": "string", "description": "Keep only posts published on or after this date. Use a date (2026-10-01), an ISO date-time in UTC (2026-10-01T12:00:00Z), or a relative value such as \"7 days\" or \"12 hours\". Profiles stop at the first older posts, so you pay only for what is in range. Post links are always returned. Leave empty for no limit.", "default": "" }, "onlyNewPosts": { "title": "Only new posts (monitoring mode)", "type": "boolean", "description": "Remember what was delivered for each profile and search term and, on later runs, return only posts published since monitoring began and not delivered yet. The first run returns posts like a normal run. Run it on a schedule to follow accounts or topics. Post links are not affected.", "default": false }, "monitorName": { "title": "Monitor name", "pattern": "^[A-Za-z0-9][A-Za-z0-9-]{0,29}$", "type": "string", "description": "Name of the memory used by monitoring mode, kept in a key-value store of your account. Runs with the same name share it, so use one name per schedule. Letters, digits and hyphens only.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Threads answers Apify's servers directly, so no proxy is used by default. Apify datacenter proxy was refused by Threads in testing; choose a proxy here only if you want every request to go through it.", "default": { "useApifyProxy": 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 } } } } } } } } } }