{ "openapi": "3.0.1", "info": { "title": "Threads Lead Finder – Public Hiring Posts", "description": "Discover publicly visible Threads posts where people may be looking for web developers, designers, marketers, and other freelancers. Supports six service categories, custom keywords, niche targeting, and exportable lead lists.", "version": "0.2", "x-build-id": "x3Vt4Khz3Qrhr4yah" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abdul_wajid_khan~threads-lead-finder-local-first/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abdul_wajid_khan-threads-lead-finder-local-first", "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/abdul_wajid_khan~threads-lead-finder-local-first/runs": { "post": { "operationId": "runs-sync-abdul_wajid_khan-threads-lead-finder-local-first", "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/abdul_wajid_khan~threads-lead-finder-local-first/run-sync": { "post": { "operationId": "run-sync-abdul_wajid_khan-threads-lead-finder-local-first", "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": { "category": { "title": "Service category", "enum": [ "all", "web", "wordpress", "branding", "graphics", "marketing", "saas" ], "type": "string", "description": "Choose all six service categories or one category. Filling Custom service overrides this choice.", "default": "all" }, "customService": { "title": "Custom service (optional)", "type": "string", "description": "Example: landing page design. When filled, this overrides the service category." }, "customTerms": { "title": "Related custom terms", "type": "string", "description": "Optional comma-separated related search phrases. Example: sales page, funnel page, conversion page. Use with Custom service." }, "niche": { "title": "Niche (optional)", "type": "string", "description": "Optional business niche, such as dentist, restaurant or cafe. Narrow niches can return zero results." }, "focus": { "title": "Narrow focus (optional)", "type": "string", "description": "Example: landing page. Used to guide discovery, not a strict exact-match filter." }, "depth": { "title": "Search depth", "enum": [ "quick", "standard", "deep" ], "type": "string", "description": "Quick uses up to 6 terms per selected category; standard up to 12; deep up to 20.", "default": "quick" }, "maxQueries": { "title": "Maximum search phrases", "minimum": 1, "maximum": 120, "type": "integer", "description": "Number of unique search phrases (each searches Recent and Top). Larger values cost more compute and may produce duplicates.", "default": 18 }, "maxAuthors": { "title": "Maximum authors to audit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum candidate authors to check. This is NOT a target number of results.", "default": 35 }, "hours": { "title": "Lookback (hours)", "minimum": 1, "maximum": 168, "type": "integer", "description": "Only posts from the last N hours are considered.", "default": 24 }, "delaySeconds": { "title": "Delay between requests (seconds)", "minimum": 2, "maximum": 30, "type": "integer", "description": "Pause between network calls to avoid aggressive repeated requests.", "default": 3 }, "excludedAccounts": { "title": "Excluded accounts", "type": "string", "description": "Optional account handles to skip, separated by commas or lines. Your local exclusion file is not uploaded." }, "previewOnly": { "title": "Preview search plan only", "type": "boolean", "description": "Preview the search plan without scraping Threads or generating candidate leads.", "default": false } } }, "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 } } } } } } } } } }