{
"openapi": "3.0.1",
"info": {
"title": "Meta Threads Scraper",
"description": "Collect public Meta Threads posts, profiles and search results without login. Stable IDs, UTC timestamps, honest nulls and per-input diagnostics.",
"version": "0.1",
"x-build-id": "BeRdoPjtuJxcZ3Is5"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapelabmax~meta-threads-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapelabmax-meta-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/scrapelabmax~meta-threads-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapelabmax-meta-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/scrapelabmax~meta-threads-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapelabmax-meta-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",
"required": [
"mode"
],
"properties": {
"mode": {
"title": "Mode",
"enum": [
"user_posts",
"user_replies",
"user_reposts",
"search_posts",
"search_profiles",
"post_urls"
],
"type": "string",
"description": "What to scrape. User posts, User replies and User reposts read the usernames list; Search posts and Search profiles read keywords; Post URLs reads postUrls. Replies and reposts expose a single public page per user; search exposes at most 20 posts (or about 13 profiles) per keyword.",
"default": "user_posts"
},
"usernames": {
"title": "Usernames",
"uniqueItems": true,
"type": "array",
"description": "Public Threads accounts for the user modes. Accepts zuck, @zuck or https://www.threads.com/@zuck. Private accounts return a private status and no rows.",
"items": {
"type": "string"
}
},
"keywords": {
"title": "Keywords / hashtags",
"uniqueItems": true,
"type": "array",
"description": "Search terms for the search modes, e.g. open source or #threads. Each keyword is one input. Public search returns at most 20 posts per keyword and sort order, and about 13 profiles; this is a Threads limit, not a setting.",
"items": {
"type": "string"
}
},
"postUrls": {
"title": "Post URLs",
"uniqueItems": true,
"type": "array",
"description": "Links for the Post URLs mode: https://www.threads.com/@user/post/CODE. Legacy threads.net links and /media deep links are normalized to the same post. Other hosts are rejected.",
"items": {
"type": "string"
}
},
"sort": {
"title": "Search sort",
"enum": [
"top",
"recent"
],
"type": "string",
"description": "Ordering of Search posts results, mirroring the Top / Recent tabs on Threads. Ignored by the other modes.",
"default": "top"
},
"maxResultsPerInput": {
"title": "Max results per input",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Upper bound of post (or profile) rows emitted per username, keyword or URL. Pagination stops as soon as this many rows were accepted. The optional profile row (see Include profile rows) does not count against it. Search cannot exceed the 20-per-keyword source cap regardless of this value.",
"default": 50
},
"maxTotalResults": {
"title": "Max total results",
"minimum": 1,
"type": "integer",
"description": "Global cap for the whole run across all inputs. When reached, remaining inputs are not started and the run finishes with status budget_reached. Together with the Apify per-run spending limit this bounds your bill.",
"default": 1000
},
"since": {
"title": "Since (UTC)",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
"type": "string",
"description": "Keep only posts created on or after this ISO-8601 date, e.g. 2026-01-01 or 2026-01-01T00:00:00Z. Filtering happens after fetching and before billing, so it reduces what you pay, not the number of requests. Posts without a timestamp are dropped when a date filter is set."
},
"until": {
"title": "Until (UTC)",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
"type": "string",
"description": "Keep only posts created on or before this ISO-8601 date (inclusive, UTC). Same format as Since."
},
"minLikes": {
"title": "Minimum likes",
"minimum": 0,
"type": "integer",
"description": "Keep only posts with at least this many likes. Posts whose like count is hidden by the author (like_count: null) are dropped when this filter is set, because the value cannot be verified."
},
"includeProfiles": {
"title": "Include profile rows",
"type": "boolean",
"description": "User modes only. Also emit one profile record per username before its posts. Each profile row is a separate billable result ($0.0015), so it is off by default.",
"default": false
},
"includeReplies": {
"title": "Include replies (Post URLs mode)",
"type": "boolean",
"description": "Post URLs mode only. Also emit the direct replies to each post (source_tab: post_replies), paginated under the same limits. Replies are billed like any other post row. Nested reply trees are not followed.",
"default": false
},
"maxRequestsPerInput": {
"title": "Max source requests per input",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Hard stop on page fetches per username / keyword / URL, including the first page. Protects against runaway pagination on very large accounts. User posts return roughly 10 to 22 posts per request.",
"default": 30
},
"onlyNew": {
"title": "Only new results (beta)",
"type": "boolean",
"description": "Suppress posts already delivered by earlier runs of the same named monitor, so a scheduled run only bills what is new. Requires Monitor name. Supported for User posts and Search posts. The first run of a monitor emits everything it finds. State is stored in a key-value store owned by your Apify account.",
"default": false
},
"monitorName": {
"title": "Monitor name",
"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,62}$",
"type": "string",
"description": "Identifier for the monitor's state, e.g. brand-mentions. Use the same name on every scheduled run you want deduplicated against each other. Letters, digits, dashes and underscores; 1 to 63 characters."
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Proxy settings passed to Apify Proxy. Keep Apify Proxy enabled; Threads throttles repeated requests from a single address, which shows up as rate_limited inputs.",
"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
}
}
}
}
}
}
}
}
}
}