{ "openapi": "3.0.1", "info": { "title": "Threads Brand Mentions, Keyword Alerts & Influencer Discovery", "description": "Monitor Meta Threads for brand mentions, keyword alerts, and creator activity. Input handles, search terms, or post URLs. Returns text, like and reply counts, mentions, hashtags, media URLs, and timestamps. Built for social listening, PR teams, and influencer marketers. Pay per post.", "version": "0.1", "x-build-id": "WwjtWX1QNwjKh6E17" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~meta-threads-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-meta-threads-intelligence", "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/scrapemint~meta-threads-intelligence/runs": { "post": { "operationId": "runs-sync-scrapemint-meta-threads-intelligence", "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/scrapemint~meta-threads-intelligence/run-sync": { "post": { "operationId": "run-sync-scrapemint-meta-threads-intelligence", "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": "Threads handles", "type": "array", "description": "Public Threads handles to pull recent posts from. Leading @ is optional. Examples: zuck, mosseri, natemurray.", "default": [], "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keyword searches against Threads. Returns top matching posts. Use brand names, product names, or topics for monitoring.", "default": [], "items": { "type": "string" } }, "postUrls": { "title": "Post URLs", "type": "array", "description": "Specific post permalinks (https://www.threads.com/@user/post/CODE). Returns the post and any author engagement metrics rendered on the page.", "default": [], "items": { "type": "string" } }, "minLikes": { "title": "Minimum likes", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop posts with fewer likes. Useful for filtering noise on broad keyword searches. Set to 0 to keep everything.", "default": 0 }, "minReplies": { "title": "Minimum replies", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop posts with fewer replies.", "default": 0 }, "verifiedOnly": { "title": "Verified authors only", "type": "boolean", "description": "Keep only posts from accounts with the Meta verified badge.", "default": false }, "maxItemsPerSource": { "title": "Max posts per source", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on posts returned per handle, search term, or post URL.", "default": 25 }, "maxItemsTotal": { "title": "Max posts per run", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Hard cap across all sources. Controls total cost.", "default": 100 }, "scrollPasses": { "title": "Scroll passes", "minimum": 0, "maximum": 30, "type": "integer", "description": "Number of times to scroll the page to trigger lazy loaded posts. Each pass typically loads 5 to 10 more posts. Higher values cost more time per source.", "default": 3 }, "dedupe": { "title": "Deduplicate across runs", "type": "boolean", "description": "Skip posts already pushed in previous runs (key is post code). Turn off to track engagement changes over time.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy. Threads accepts datacenter for moderate volume. Switch to residential if you see soft blocks.", "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 } } }, "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 } } } } } } } } } }