{ "openapi": "3.0.1", "info": { "title": "Scrape Threads Profile Data - Threads Post URL, No Login", "description": "Threads analytics for every public profile: a threads post history scraper returning exact likes, replies, reposts and quotes. Threads competitor analysis, brand monitoring, threads content analysis, threads post analysis, threads reply analysis. Threads data api, threads post id, threads stats.", "version": "0.1", "x-build-id": "xDMOkISVBPbONGkIZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/k1ra~scrape-meta-threads-posts-profile/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-k1ra-scrape-meta-threads-posts-profile", "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/k1ra~scrape-meta-threads-posts-profile/runs": { "post": { "operationId": "runs-sync-k1ra-scrape-meta-threads-posts-profile", "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/k1ra~scrape-meta-threads-posts-profile/run-sync": { "post": { "operationId": "run-sync-k1ra-scrape-meta-threads-posts-profile", "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": "Public Threads handles or profile URLs to scrape the full post history from (e.g. 'zuck' or 'https://www.threads.com/@zuck'). This is the primary input — profiles have no depth limit. A profile that can't be fetched is skipped; the rest of the run still returns.", "items": { "type": "string" } }, "postUrls": { "title": "Post URLs", "type": "array", "description": "Individual post URLs to resolve (e.g. 'https://www.threads.com/@zuck/post/ABCdef123'). Each returns the full post record with exact engagement counts.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords or hashtags to collect a snapshot of matching public posts (e.g. 'nike'). Search returns a snapshot of roughly 40-45 posts per query, not a full archive — see the actor's README.", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "Max posts per profile", "minimum": 1, "type": "integer", "description": "Stop after this many posts per profile. This is the main cost guard — set it to what you actually need.", "default": 100 }, "onlyNewerThan": { "title": "Only newer than (date)", "type": "string", "description": "Only keep posts published on or after this date (ISO format, e.g. '2026-01-01'). The run stops once it is past this window instead of walking the whole profile." }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also return the reply snapshot for every post found (roughly 45 top and recent replies per post). This adds requests, so runs take longer.", "default": false }, "includeMediaUrls": { "title": "Include media URLs", "type": "boolean", "description": "Include image and video URLs for each post. These carry access tokens and expire — download promptly if you need the files.", "default": true }, "onlyNewPosts": { "title": "Only new posts (monitoring mode)", "type": "boolean", "description": "Remember every post across runs and only output ones never seen before. Schedule this actor and get ONLY fresh posts each run — no repeats. Follow-up runs stop once they reach posts already reported, so they finish far faster than the first one.", "default": false }, "monitoringId": { "title": "Monitoring ID", "type": "string", "description": "Optional name for the monitoring memory. Use different IDs to keep separate watch-lists (e.g. 'competitors' and 'my-brand')." } } }, "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 } } } } } } } } } }