{ "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": "WTtcL01AbUPNQE2yu" }, "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": [ "Arts and Design", "Consulting", "Customer Success and Support", "Engineering", "Finance", "Human Resources", "Legal", "Marketing", "Operations", "Product Management", "Research", "Sales" ] } }, "excludeJobFunctions": { "title": "Exclude Job Functions", "type": "array", "description": "Drop anyone whose current role is in one of these functions.", "items": { "type": "string", "enum": [ "Arts and Design", "Consulting", "Customer Success and Support", "Engineering", "Finance", "Human Resources", "Legal", "Marketing", "Operations", "Product Management", "Research", "Sales" ] } }, "seniority": { "title": "Seniority Levels", "type": "array", "description": "Seniority / career levels to match (OR logic).", "items": { "type": "string", "enum": [ "CXO", "Director", "Entry Level", "Entry Level Manager", "Experienced Manager", "In Training", "Owner / Partner", "Senior", "Strategic", "Vice President" ] } }, "excludeSeniority": { "title": "Exclude Seniority Levels", "type": "array", "description": "Drop anyone whose current role is at one of these levels.", "items": { "type": "string", "enum": [ "CXO", "Director", "Entry Level", "Entry Level Manager", "Experienced Manager", "In Training", "Owner / Partner", "Senior", "Strategic", "Vice President" ] } }, "yearsOfExperienceMin": { "title": "Years of Experience Min", "minimum": 0, "type": "integer", "description": "Minimum total years of work experience (inclusive)." }, "yearsOfExperienceMax": { "title": "Years of Experience Max", "minimum": 0, "type": "integer", "description": "Maximum total years of work experience (inclusive)." }, "yearsInCurrentRoleMin": { "title": "Years in Current Role Min", "minimum": 0, "type": "integer", "description": "Minimum years at the current employer (inclusive)." }, "yearsInCurrentRoleMax": { "title": "Years in Current Role Max", "minimum": 0, "type": "integer", "description": "Maximum years at the current employer (inclusive)." }, "recentlyChangedJobs": { "title": "Recently Changed Jobs", "type": "boolean", "description": "Only people who started their current role in about the last 3 months. New leaders often buy new tools." }, "pastCompanies": { "title": "Past Companies", "type": "array", "description": "Companies the person worked at before, by name (OR logic), e.g. 'Google'.", "items": { "type": "string" } }, "excludePastCompanies": { "title": "Exclude Past Companies", "type": "array", "description": "Drop anyone who worked at any of these companies before.", "items": { "type": "string" } }, "pastJobTitles": { "title": "Past Job Titles", "type": "array", "description": "Job titles held in a past role (OR logic), e.g. 'Founder'.", "items": { "type": "string" } }, "excludePastJobTitles": { "title": "Exclude Past Job Titles", "type": "array", "description": "Drop anyone who held any of these job titles in a past role.", "items": { "type": "string" } }, "pastSeniority": { "title": "Past Seniority Levels", "type": "array", "description": "Career level of a past role (OR logic).", "items": { "type": "string", "enum": [ "CXO", "Director", "Entry Level", "Entry Level Manager", "Experienced Manager", "In Training", "Owner / Partner", "Senior", "Strategic", "Vice President" ] } }, "excludePastSeniority": { "title": "Exclude Past Seniority Levels", "type": "array", "description": "Drop anyone who held any of these levels in a past role.", "items": { "type": "string", "enum": [ "CXO", "Director", "Entry Level", "Entry Level Manager", "Experienced Manager", "In Training", "Owner / Partner", "Senior", "Strategic", "Vice President" ] } }, "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" } }, "excludeCompanyDomains": { "title": "Exclude Company Domains", "type": "array", "description": "Company website domains to exclude, e.g. 'stripe.com'. More exact than names when you upload an account list from your CRM.", "items": { "type": "string" } }, "companyHqCountries": { "title": "Company HQ Countries", "type": "array", "description": "Country where the current employer has its headquarters (OR logic), e.g. 'Germany' or 'DEU'. This is where the company is based, not the person.", "items": { "type": "string" } }, "excludeCompanyHqCountries": { "title": "Exclude Company HQ Countries", "type": "array", "description": "Drop people whose current employer has its headquarters in any of these countries.", "items": { "type": "string" } }, "companyTypes": { "title": "Company Types", "type": "array", "description": "Type of current employer (OR logic).", "items": { "type": "string", "enum": [ "Educational Institution", "Government Agency", "Non-profit", "Partnership", "Privately Held", "Public Company", "Self-Employed", "Sole Proprietorship" ] } }, "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" } }, "excludeIndustries": { "title": "Exclude Industries", "type": "array", "description": "Industries to exclude (current employer), e.g. 'Staffing & Recruiting'. A word that matches no industry stops the run before any charge.", "items": { "type": "string" } }, "skills": { "title": "Skills", "type": "array", "description": "Skills listed on the profile (OR logic), e.g. 'Salesforce', 'Python'.", "items": { "type": "string" } }, "excludeSkills": { "title": "Exclude Skills", "type": "array", "description": "Drop anyone who lists any of these skills.", "items": { "type": "string" } }, "languages": { "title": "Languages", "type": "array", "description": "Languages the person speaks (OR logic), e.g. 'French', 'German'.", "items": { "type": "string" } }, "excludeLanguages": { "title": "Exclude Languages", "type": "array", "description": "Drop anyone who lists any of these languages.", "items": { "type": "string" } }, "schools": { "title": "Schools", "type": "array", "description": "Schools or universities attended (OR logic), e.g. 'Stanford', 'HEC Paris'.", "items": { "type": "string" } }, "excludeSchools": { "title": "Exclude Schools", "type": "array", "description": "Drop anyone who attended any of these schools.", "items": { "type": "string" } }, "certifications": { "title": "Certifications", "type": "array", "description": "Certifications held (OR logic), e.g. 'PMP', 'AWS Certified'.", "items": { "type": "string" } }, "excludeCertifications": { "title": "Exclude Certifications", "type": "array", "description": "Drop anyone who holds any of these certifications.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Free-text keywords (OR logic). A lead matches if ANY entry appears on their profile (headline, bio or company name), e.g. 'cold calling', 'appointment setting'.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude Keywords", "type": "array", "description": "Drop anyone whose profile contains any of these words.", "items": { "type": "string" } }, "openTo": { "title": "Open To", "type": "array", "description": "Signals the person shows on their own profile (OR logic). \"Hiring\" is the strongest outbound signal.", "items": { "type": "string", "enum": [ "hiring", "open_to_work", "volunteering" ], "enumTitles": [ "Hiring", "Open to work", "Volunteering" ] } }, "minFollowers": { "title": "Minimum LinkedIn Followers", "minimum": 0, "type": "integer", "description": "Only people with at least this many LinkedIn followers, e.g. 5000." }, "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" } }, "excludeCountries": { "title": "Exclude Countries", "type": "array", "description": "Countries to exclude, e.g. \"United States except California\" = Countries: United States + Exclude States: California.", "items": { "type": "string" } }, "excludeStates": { "title": "Exclude States / Regions", "type": "array", "description": "States or provinces to exclude.", "items": { "type": "string" } }, "excludeCities": { "title": "Exclude Cities", "type": "array", "description": "Cities to exclude.", "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 }, "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 } } } } } } } } } }