{ "openapi": "3.0.1", "info": { "title": "Leads Finder - B2B List Building", "description": "Build a targeted B2B lead list with filters for job title, seniority, company size, industry, keyword and location. Full profiles with company details and LinkedIn URL.", "version": "0.0", "x-build-id": "m8YYDS4uIdwoWgk8T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scalelist~leads-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scalelist-leads-finder", "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/scalelist~leads-finder/runs": { "post": { "operationId": "runs-sync-scalelist-leads-finder", "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/scalelist~leads-finder/run-sync": { "post": { "operationId": "run-sync-scalelist-leads-finder", "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": { "maxResults": { "title": "Number of leads to extract", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many leads to return (1 to 10,000). You are charged per lead delivered to the dataset.", "default": 100 }, "jobTitles": { "title": "Job Titles", "type": "array", "description": "Job titles to match (OR logic), e.g. 'CEO', 'Head of Sales'.", "items": { "type": "string" } }, "excludeJobTitles": { "title": "Exclude Job Titles", "type": "array", "description": "Job titles to exclude. Applied after the filters above.", "items": { "type": "string" } }, "jobFunctions": { "title": "Job Functions", "type": "array", "description": "Functional departments to match (OR logic).", "items": { "type": "string", "enum": [ "Operations", "Business Development", "Sales", "Education", "Engineering", "Healthcare Services", "Information Technology", "Administrative", "Arts and Design", "Customer Success and Support", "Finance", "Community and Social Services", "Media and Communication", "Accounting", "Marketing", "Human Resources", "Research", "Program and Project Management", "Legal", "Military and Protective Services", "Consulting", "Entrepreneurship", "Real Estate", "Quality Assurance", "Purchasing", "Product Management", "Leadership" ] } }, "seniority": { "title": "Seniority Levels", "type": "array", "description": "Seniority / career levels to match (OR logic).", "items": { "type": "string", "enum": [ "Owner / Founder", "CXO", "Partner", "VP", "Head", "Director", "Manager", "Senior", "Entry", "Intern" ] } }, "companies": { "title": "Company Name", "type": "array", "description": "Names of companies to include (OR logic), e.g. 'Google', 'Stripe'. Match on the company's name, not its website — use Company Domains for that.", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude Company Name", "type": "array", "description": "Names of companies to exclude from results.", "items": { "type": "string" } }, "companyDomains": { "title": "Company Domains", "type": "array", "description": "Company website domains to include, e.g. 'google.com', 'stripe.com'.", "items": { "type": "string" } }, "companySizeMin": { "title": "Company Size Min", "minimum": 1, "type": "integer", "description": "Minimum employee count (inclusive)." }, "companySizeMax": { "title": "Company Size Max", "minimum": 1, "type": "integer", "description": "Maximum employee count (inclusive)." }, "industries": { "title": "Industries", "type": "array", "description": "Industries to match, e.g. 'Computer Software', 'Financial Services'.", "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text keyword matched anywhere across the profile." }, "countries": { "title": "Countries", "type": "array", "description": "Countries to match, e.g. 'United States', 'United Kingdom', 'France'.", "items": { "type": "string" } }, "states": { "title": "States / Regions", "type": "array", "description": "States or provinces to match, e.g. 'California', 'Texas', 'Ontario'.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Cities to match, e.g. 'San Francisco', 'London', 'Singapore'.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }