{ "openapi": "3.0.1", "info": { "title": "B2B LinkedIn Lead Generator", "description": "Find B2B decision-makers on LinkedIn by describing your ideal customer. AI discovers matching companies from live web data, identifies the right people, and scores every lead for relevance. Pay only for qualifying leads.", "version": "1.0", "x-build-id": "UwwubSCtN6tumKrcd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chieftools~b2b-linkedin-lead-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chieftools-b2b-linkedin-lead-generator", "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/chieftools~b2b-linkedin-lead-generator/runs": { "post": { "operationId": "runs-sync-chieftools-b2b-linkedin-lead-generator", "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/chieftools~b2b-linkedin-lead-generator/run-sync": { "post": { "operationId": "run-sync-chieftools-b2b-linkedin-lead-generator", "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": [ "jobTitles", "industries", "locations" ], "properties": { "maxLeads": { "title": "Maximum Leads", "minimum": 10, "maximum": 500, "type": "integer", "description": "Maximum number of leads to return. Each lead costs $0.06 on top of the $2.00 base fee. Example: 50 leads = $5.00 total.", "default": 50 }, "runLabel": { "title": "Run Label", "type": "string", "description": "An optional label to tag this run (e.g. \"Q1 DACH outreach\"). Appears in the stats output for your reference." }, "jobTitles": { "title": "Job Titles", "minItems": 1, "type": "array", "description": "Job titles of the people you want to find. Each entry can contain multiple variations separated by commas (e.g. \"CTO, Chief Technology Officer\"). Add as many title groups as you like.", "items": { "type": "string" } }, "excludeJobTitles": { "title": "Exclude Job Titles", "type": "array", "description": "Exclude leads whose title contains any of these keywords (case-insensitive). For example, \"intern\" will exclude \"Marketing Intern\" and \"assistant\" will exclude \"Executive Assistant\".", "items": { "type": "string" }, "default": [] }, "seniorityLevels": { "title": "Seniority Level", "type": "array", "description": "Only include leads at these seniority levels. Leave empty to include all levels.", "items": { "type": "string", "enum": [ "founder", "c_suite", "vp", "director", "head", "manager", "senior", "entry", "intern" ], "enumTitles": [ "Founder", "C-Suite", "VP", "Director", "Head", "Manager", "Senior", "Entry Level", "Intern" ] }, "default": [ "c_suite", "vp", "director", "head" ] }, "departments": { "title": "Department", "type": "array", "description": "Only include leads from these departments. Leave empty to include all departments.", "items": { "type": "string", "enum": [ "executive", "engineering", "product", "design", "marketing", "sales", "finance", "operations", "hr", "it", "legal", "support" ], "enumTitles": [ "Executive", "Engineering", "Product", "Design", "Marketing", "Sales", "Finance", "Operations", "HR / People", "IT / Security", "Legal / Compliance", "Support / Customer Success" ] }, "default": [] }, "industries": { "title": "Target Industries", "minItems": 1, "type": "array", "description": "Industries or market segments to search. Be as specific or broad as you like — examples: \"SaaS & Cloud Platforms\", \"Fintech\", \"Healthcare IT\", \"E-commerce\", \"Cybersecurity\".", "items": { "type": "string" } }, "companyDescription": { "title": "Company Description", "type": "string", "description": "A short description of the companies you're targeting. Used to improve AI search accuracy. Example: \"Fast-growing B2B startups building developer tools\" or \"Mid-market e-commerce brands selling DTC\"." }, "companyKeywords": { "title": "Company Keywords", "type": "array", "description": "Extra keywords appended to auto-generated search queries (e.g. \"AI\", \"developer tools\", \"Series B\"). Only affects auto-generated queries, not custom search queries.", "items": { "type": "string" }, "default": [] }, "minEmployees": { "title": "Min Employees", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only include companies with at least this many employees. Set to 0 to include all sizes.", "default": 50 }, "maxEmployees": { "title": "Max Employees", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Exclude companies with more than this many employees. Leave empty or set to 0 for no upper limit.", "default": 0 }, "locations": { "title": "Target Locations", "minItems": 1, "type": "array", "description": "Geographic locations to focus on. Can be countries, states, cities, or regions. Examples: \"California\", \"United Kingdom\", \"Berlin\", \"DACH region\", \"Southeast Asia\".", "items": { "type": "string" } }, "excludeLocations": { "title": "Exclude Locations", "type": "array", "description": "Remove leads whose company or contact location matches any of these (case-insensitive). Example: \"India\" excludes any lead located in India.", "items": { "type": "string" }, "default": [] }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Custom search queries to find companies. Leave empty to auto-generate queries from your industry and location settings.", "items": { "type": "string" } }, "similarCompanyUrls": { "title": "Similar Company URLs", "type": "array", "description": "Websites of companies similar to your targets. We'll find more companies like these. Great for expanding beyond keyword search.", "items": { "type": "string" }, "default": [] }, "excludeDomains": { "title": "Exclude Domains", "type": "array", "description": "Domains to exclude from results — your own company, existing customers, known competitors, or irrelevant sites.", "items": { "type": "string" }, "default": [] }, "minConfidence": { "title": "Min Confidence Score", "minimum": 0, "maximum": 1, "type": "number", "description": "AI relevance threshold (0.0-1.0). Prospects below this score are filtered out. Default 0.6 works well for most searches. Use 0.7+ for tighter targeting.", "default": 0.6 }, "enableAiEnhancement": { "title": "Enable AI Enhancement", "type": "boolean", "description": "Recommended: ON. Uses AI to expand searches, filter noise, and score prospect relevance. Significantly improves result quality.", "default": 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 } } } } } } } } } }