{ "openapi": "3.0.1", "info": { "title": "Public Business Directory Leads", "description": "Fetch bounded public business-source URLs, use optional fallback URLs when retryable sources fail, rank candidate leads, and return a reviewable result envelope with source diagnostics and quality notes.", "version": "0.1", "x-build-id": "wDOcUAdLIMZ8yakra" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/staros_dev~public-business-directory-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-staros_dev-public-business-directory-leads", "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/staros_dev~public-business-directory-leads/runs": { "post": { "operationId": "runs-sync-staros_dev-public-business-directory-leads", "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/staros_dev~public-business-directory-leads/run-sync": { "post": { "operationId": "run-sync-staros_dev-public-business-directory-leads", "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": [ "sourceUrls" ], "properties": { "sourceUrls": { "title": "Primary source URLs", "minItems": 1, "maxItems": 25, "uniqueItems": true, "type": "array", "description": "Paste the public URLs Proteus should check first. Good inputs are directory pages you already use, direct business websites, or public listing pages. This actor does not discover URLs for you.", "items": { "type": "string", "pattern": "^https?://.+" } }, "fallbackSourceUrls": { "title": "Fallback source URLs (optional)", "maxItems": 25, "uniqueItems": true, "type": "array", "description": "Optional backup URLs to use only when a primary source is blocked or times out. Best choices are direct business websites or official public records that can still produce a useful lead row.", "items": { "type": "string", "pattern": "^https?://.+" } }, "region": { "title": "Region label (optional)", "minLength": 1, "maxLength": 120, "type": "string", "description": "Plain-English region label carried into the execution plan and ranking context. It does not trigger search discovery by itself." }, "businessCategories": { "title": "Business categories (optional)", "maxItems": 25, "type": "array", "description": "Optional ranking hints. Choose categories that match the URLs you submitted, or type your own labels.", "items": { "type": "string", "enumSuggestedValues": [ "plumbing", "hvac", "roofing", "electrical", "dentists", "med spas", "legal" ] } }, "maxResults": { "title": "How many leads to return", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum number of ranked lead rows to return in the dataset and OUTPUT artifact.", "default": 5 }, "pageLimit": { "title": "How many pages to fetch", "minimum": 1, "maximum": 25, "type": "integer", "description": "Total page budget for both primary and fallback URLs. Keep this close to the number of URLs you submit unless you need extra retry room.", "default": 6 }, "idempotencyKey": { "title": "Run key (optional)", "minLength": 1, "maxLength": 200, "type": "string", "description": "Optional stable key for reruns of the same request. Leave blank unless you want to track or deduplicate a repeated run." } } }, "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 } } } } } } } } } }