{ "openapi": "3.0.1", "info": { "title": "Threads Scraper - Profile Posts, Search & Hashtags, No Login", "description": "Scrape Meta Threads (threads.com, threads.net) without login: every public post of a profile, keyword and #hashtag search (top or recent), posts by link. Text, date, likes, replies, reposts, quotes, images, videos, mentions and author. Only new posts on schedules. US$ 5 per 1,000.", "version": "0.1", "x-build-id": "VhTpbK0XRGVVJHrLG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapewise~threads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapewise-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/scrapewise~threads-scraper/runs": { "post": { "operationId": "runs-sync-scrapewise-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/scrapewise~threads-scraper/run-sync": { "post": { "operationId": "run-sync-scrapewise-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": "Profiles", "type": "array", "description": "Threads usernames or profile links, one per line (for example zuck, @nasa or https://www.threads.com/@meta). Returns the profile's public posts, newest first, page after page, with text, date, likes, replies, reposts, quotes and media. Leave every list empty to run the example profile. Also accepts 'profiles' or 'profileUrls'.", "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords or #hashtags, one per line (for example ai agents or #photography). Each returns the posts Threads shows for it, about 25 to 35 per keyword, in the order chosen below. Every row keeps its keyword. Also accepts 'keywords' or 'queries'.", "items": { "type": "string" } }, "searchSort": { "title": "Search order", "enum": [ "top", "recent" ], "type": "string", "description": "Order of keyword search results: Top (default, the posts Threads ranks highest) or Recent (newest first, the right choice for monitoring a topic). Used only with Search keywords.", "default": "top" }, "postUrls": { "title": "Post links", "type": "array", "description": "Specific Threads posts, one per line, as threads.com/@user/post/CODE links (threads.net links work too). Each link returns that single post. Also accepts 'urls' or 'startUrls'.", "items": { "type": "string" } }, "maxItems": { "title": "Max posts per profile or keyword", "minimum": 1, "type": "integer", "description": "Upper limit of posts for each profile or keyword (default 50). With 3 profiles and 50 here a run delivers up to 150 posts. You pay per post delivered. Also accepts 'maxPostsPerSource'.", "default": 50 }, "excludeReplies": { "title": "Skip the profile's replies", "type": "boolean", "description": "On (default): keeps only the profile's own posts, not the replies it wrote under other people's posts. Turn off to also get its replies. Used only with Profiles.", "default": true }, "onlyNew": { "title": "Only new posts since the last run", "type": "boolean", "description": "For scheduled Tasks. Remembers which posts of each profile, keyword and post list were already delivered (in a named key-value store in your account, 'threads-scraper-only-new') and skips them on later runs: not delivered, not charged and not counted in Max posts. Profiles stop paging at the first post you already have. Delete that store to start over. Also accepts 'onlyNewPosts'.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy, on by default with the datacenter group, which Threads accepts. Keep the default unless you have your own proxy.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }