{ "openapi": "3.0.1", "info": { "title": "Threads Scraper", "description": "Find Threads accounts by niche, then pull their bio, link, followers, and posts. No login needed. Search by keyword to discover new accounts, or paste accounts you already know. Export to CSV, JSON, or Excel.", "version": "0.0", "x-build-id": "bPlDoVcp8bSfm8ZqW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crustapi~threads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crustapi-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/crustapi~threads-scraper/runs": { "post": { "operationId": "runs-sync-crustapi-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/crustapi~threads-scraper/run-sync": { "post": { "operationId": "run-sync-crustapi-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": { "searchTerms": { "title": "Find Threads accounts (type a niche or topic)", "type": "array", "description": "Type what you are looking for, one per line, and we find matching public accounts with their bio, link, follower count, and verified badge. Examples:\n• fitness coach\n• marketing agency\n• real estate\n\nThis is the easiest way to find new leads. You can run with just this filled in.", "items": { "type": "string" } }, "profiles": { "title": "Or paste specific accounts (links or @handles)", "type": "array", "description": "Already know who you want? Paste accounts here, one per line, to pull their details and posts. Use a username, an @handle, or a profile link:\n• zuck\n• @mosseri\n• https://www.threads.com/@natgeo\n\nGreat for tracking competitors or enriching a list you already have. If you fill in both boxes, these pasted accounts are scraped too.", "items": { "type": "string" } }, "resultsType": { "title": "For pasted accounts, what to get", "enum": [ "profile", "posts", "replies", "reposts", "media" ], "type": "string", "description": "Only used for the accounts you paste above. The search box always returns account details.\n• Account details = bio, followers, links, verified badge\n• Posts = the account's full post history\n• Replies = posts they replied to\n• Reposts = posts they reshared\n• Media = their photos and videos only", "default": "profile" }, "maxResults": { "title": "Most results to return (cost cap)", "minimum": 0, "type": "integer", "description": "A simple cap on how many results you get, so you stay in control of cost. Leave at 0 for no limit. A small number like 50 is a good way to try it out first.", "default": 0 }, "maxPostsPerAccount": { "title": "Posts per account (0 = everything)", "minimum": 0, "type": "integer", "description": "Only used when you pick Posts, Replies, Reposts, or Media for pasted accounts. Stop after this many per account. Leave at 0 to get everything (we page past the website's 'log in to see more' wall).", "default": 0 }, "maxConcurrency": { "title": "Parallel accounts", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many accounts to work on at once. A sensible default is applied." } } }, "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 } } } } } } } } } }