{ "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.3", "x-build-id": "GOg84pizg8j3PdeLt" }, "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 }, "minRevenueUsd": { "title": "Min Annual Revenue (USD)", "minimum": 0, "type": "integer", "description": "Only include companies with at least this estimated annual revenue. Leave 0 for no lower limit.", "default": 0 }, "maxRevenueUsd": { "title": "Max Annual Revenue (USD)", "minimum": 0, "type": "integer", "description": "Only include companies at or below this estimated annual revenue. Leave 0 for no upper limit.", "default": 0 }, "foundedYearFrom": { "title": "Founded Year (From)", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Earliest company founding year (e.g., 2015 to exclude older incumbents). Leave 0 for no lower limit.", "default": 0 }, "foundedYearTo": { "title": "Founded Year (To)", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Latest company founding year (e.g., 2023 to focus on recent startups). Leave 0 for no upper limit.", "default": 0 }, "technologiesUsed": { "title": "Technologies Used", "type": "array", "description": "Only include companies using any of these technologies (e.g., \"AWS\", \"Salesforce\", \"React\"). Strong signal for tech sellers.", "items": { "type": "string" }, "default": [] }, "technologiesNotUsed": { "title": "Technologies Not Used", "type": "array", "description": "Exclude companies using any of these technologies — useful for competitive displacement plays.", "items": { "type": "string" }, "default": [] }, "hiringForTitles": { "title": "Currently Hiring For", "type": "array", "description": "Only include companies actively hiring for these roles (e.g., \"Sales Engineer\", \"DevOps\"). Strong intent signal.", "items": { "type": "string" }, "default": [] }, "minOpenJobs": { "title": "Min Open Job Postings", "minimum": 0, "type": "integer", "description": "Require at least this many current open job postings at the target company. Good proxy for growth-stage activity. Leave 0 to skip.", "default": 0 }, "companyHqLocations": { "title": "Company HQ Locations", "type": "array", "description": "Filter by company headquarters location, separate from the contact's location. Useful for global companies with distributed teams.", "items": { "type": "string" }, "default": [] }, "contactKeywords": { "title": "Contact Bio Keywords", "type": "array", "description": "Free-form keywords matched against contact bios, headlines, and descriptions (e.g., \"growth marketing\", \"Series B\", \"PLG\").", "items": { "type": "string" }, "default": [] }, "emailDeliverability": { "title": "Email Deliverability Signal", "type": "array", "description": "Quality hint even though emails aren't exported. Pick one or more delivery categories the contact should fall into.", "items": { "type": "string", "enum": [ "verified", "likely_to_engage", "unavailable" ], "enumTitles": [ "Verified", "Likely to Engage", "Unavailable" ] }, "default": [] } } }, "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 } } } } } } } } } }