{ "openapi": "3.0.1", "info": { "title": "Leads Finder ✅ B2B Emails, Apollo Alternative", "description": "Find B2B leads across 500M+ people with Apollo-style filters: title, seniority, department, location, company industry, size, tech, revenue, funding. Each lead is a rich profile with firmographics. Optional business email + company enrichment. Pay per lead. Cheaper than Apollo, ZoomInfo & Lusha.", "version": "1.0", "x-build-id": "8XAl3fua26ItLHYrg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/atomus~leads-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-atomus-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/atomus~leads-finder/runs": { "post": { "operationId": "runs-sync-atomus-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/atomus~leads-finder/run-sync": { "post": { "operationId": "run-sync-atomus-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": { "title": { "title": "💼 Job titles", "type": "array", "description": "Match leads whose CURRENT title contains any of these, e.g. \"Software Engineer\", \"Account Executive\". Leave empty for all titles.", "items": { "type": "string" } }, "titleMatchMode": { "title": "🎯 Title match mode", "enum": [ "SMART", "WORD", "STRICT" ], "type": "string", "description": "SMART = fuzzy (recommended, catches \"Sr. Software Engineer\"). WORD = whole words. STRICT = exact title only. Also applies to the Exclude titles filter below.", "default": "SMART" }, "seniority": { "title": "🎖️ Seniority", "type": "array", "description": "Keep only these seniority levels. Leave empty for all.", "items": { "type": "string", "enum": [ "c_suite", "vp", "director", "manager", "senior", "mid-level", "entry", "intern", "owner", "founder", "head", "partner" ] } }, "department": { "title": "🗂️ Department / function", "type": "array", "description": "Keep only these departments/functions. Leave empty for all.", "items": { "type": "string", "enum": [ "engineering", "information_technology", "sales", "marketing", "operations", "finance", "human_resources", "legal", "business_development", "product_management", "customer_success_and_support", "consulting", "research", "arts_and_design", "media_and_communication", "administrative", "accounting", "quality_assurance", "purchasing", "real_estate", "program_and_project_management", "entrepreneurship", "healthcare_services" ] } }, "location": { "title": "📍 Locations (person)", "type": "array", "description": "Keep only leads in these locations, using standard location names (country, region, or continent), e.g. \"United States\", \"Ireland\", \"California\". Leave empty for all.", "items": { "type": "string" } }, "keyword": { "title": "🔍 Keywords", "type": "array", "description": "Free-text keywords matched in the lead's headline/summary, e.g. \"kubernetes\", \"payments\". Leave empty to skip.", "items": { "type": "string" } }, "skill": { "title": "🛠️ Skills", "type": "array", "description": "Free-text skills the lead lists, e.g. \"Kubernetes\", \"Salesforce\". Leave empty to skip.", "items": { "type": "string" } }, "maxResults": { "title": "💯 Max results", "minimum": 1, "maximum": 2500, "type": "integer", "description": "Hard cap on how many leads to return. This is your spend cap (you pay per lead returned). The run stops once it hits this or runs out of matches. LinkedIn surfaces at most a few thousand per query.", "default": 100 }, "profileBadge": { "title": "⚡ LinkedIn badges (buying-intent)", "type": "array", "description": "Keep only leads carrying these LinkedIn badges. \"hiring\" and \"openToWork\" are strong intent signals. Leave empty for all.", "items": { "type": "string", "enum": [ "openToWork", "hiring", "jobSeeker", "premium", "creator", "openLink" ], "enumTitles": [ "Open to work", "Hiring", "Job seeker", "Premium", "Creator", "Open link" ] } }, "excludeTitle": { "title": "🚫 Exclude titles", "type": "array", "description": "Drop leads whose CURRENT title matches any of these (uses the Title match mode above), e.g. exclude \"intern\", \"assistant\". Leave empty to skip.", "items": { "type": "string" } }, "excludeSeniority": { "title": "🚫 Exclude seniority", "type": "array", "description": "Drop leads at these seniority levels. Leave empty to skip.", "items": { "type": "string", "enum": [ "c_suite", "vp", "director", "manager", "senior", "mid-level", "entry", "intern", "owner", "founder", "head", "partner" ] } }, "excludeDepartment": { "title": "🚫 Exclude department / function", "type": "array", "description": "Drop leads in these departments/functions. Leave empty to skip.", "items": { "type": "string", "enum": [ "engineering", "information_technology", "sales", "marketing", "operations", "finance", "human_resources", "legal", "business_development", "product_management", "customer_success_and_support", "consulting", "research", "arts_and_design", "media_and_communication", "administrative", "accounting", "quality_assurance", "purchasing", "real_estate", "program_and_project_management", "entrepreneurship", "healthcare_services" ] } }, "excludeLocation": { "title": "🚫 Exclude locations (person)", "type": "array", "description": "Drop leads in these locations (standard location names). Leave empty to skip.", "items": { "type": "string" } }, "fullName": { "title": "🧑 Full name", "type": "array", "description": "Match leads by full name, e.g. \"Satya Nadella\". Leave empty to skip.", "items": { "type": "string" } }, "previousTitle": { "title": "⏮️ Previous job title", "type": "array", "description": "Match leads who PREVIOUSLY held any of these titles (past roles, not current), e.g. \"Founder\". Leave empty to skip.", "items": { "type": "string" } }, "certification": { "title": "📜 Certifications", "type": "array", "description": "Match leads holding these certifications, e.g. \"AWS\", \"PMP\", \"CSM\". Leave empty to skip.", "items": { "type": "string" } }, "language": { "title": "🗣️ Languages", "type": "array", "description": "Match leads who speak these languages, e.g. \"english\", \"spanish\". Leave empty to skip.", "items": { "type": "string" } }, "degree": { "title": "🎓 Degree", "type": "array", "description": "Match leads with these degrees, e.g. \"MBA\", \"Bachelor\", \"PhD\". Leave empty to skip.", "items": { "type": "string" } }, "fieldOfStudy": { "title": "📚 Field of study", "type": "array", "description": "Match leads who studied these fields, e.g. \"Computer Science\", \"Marketing\". Leave empty to skip.", "items": { "type": "string" } }, "minCurrentJobYears": { "title": "⏳ Min years in current job", "minimum": 0, "type": "integer", "description": "Keep only leads who have been in their CURRENT job at least this many years. Leave empty for no minimum." }, "minTotalExperienceYears": { "title": "⏳ Min total years of experience", "minimum": 0, "type": "integer", "description": "Keep only leads with at least this many total years of work experience. Leave empty for no minimum." }, "companyDomain": { "title": "🌐 Company domain", "type": "array", "description": "Keep only leads at companies with these website domains, e.g. \"stripe.com\". Broad match (also drags in subsidiaries). Leave empty for all.", "items": { "type": "string" } }, "companyLinkedin": { "title": "🔗 Company LinkedIn URL", "type": "array", "description": "Keep only leads at these exact companies by LinkedIn company URL (https://www.linkedin.com/company/). More precise than domain. Leave empty for all.", "items": { "type": "string" } }, "companyIndustry": { "title": "🏭 Company industry", "type": "array", "description": "Keep only leads whose company is in these industries. Values MUST match the supported industry catalog (e.g. \"software\", \"financial services\"). Leave empty for all.", "items": { "type": "string" } }, "excludeCompanyIndustry": { "title": "🚫 Exclude company industry", "type": "array", "description": "Drop leads whose company is in these industries (supported industry catalog values). Leave empty to skip.", "items": { "type": "string" } }, "companyLocation": { "title": "🗺️ Company location", "type": "array", "description": "Keep only leads whose COMPANY is located in these standard location names (country, region, or continent). Leave empty for all.", "items": { "type": "string" } }, "excludeCompanyLocation": { "title": "🚫 Exclude company location", "type": "array", "description": "Drop leads whose company is located in these standard location names. Leave empty to skip.", "items": { "type": "string" } }, "companyTechnology": { "title": "💻 Company technology", "type": "array", "description": "Keep only leads whose company uses these technologies. Values MUST match the supported technology catalog (e.g. \"react\", \"salesforce\"). Leave empty for all.", "items": { "type": "string" } }, "excludeCompanyTechnology": { "title": "🚫 Exclude company technology", "type": "array", "description": "Drop leads whose company uses these technologies (supported technology catalog values). Leave empty to skip.", "items": { "type": "string" } }, "companyType": { "title": "🏢 Company type", "type": "array", "description": "Keep only leads whose company is one of these types. Leave empty for all.", "items": { "type": "string", "enum": [ "public_company", "privately_held", "self_owned", "self_employed", "partnership", "non_profit", "educational", "government_agency" ], "enumTitles": [ "Public company", "Privately held", "Self owned", "Self employed", "Partnership", "Non-profit", "Educational", "Government agency" ] } }, "excludeCompanyType": { "title": "🚫 Exclude company type", "type": "array", "description": "Drop leads whose company is one of these types. Leave empty to skip.", "items": { "type": "string", "enum": [ "public_company", "privately_held", "self_owned", "self_employed", "partnership", "non_profit", "educational", "government_agency" ], "enumTitles": [ "Public company", "Privately held", "Self owned", "Self employed", "Partnership", "Non-profit", "Educational", "Government agency" ] } }, "companyNaics": { "title": "🏷️ Company NAICS codes", "type": "array", "description": "Keep only leads whose company matches these NAICS industry codes, e.g. \"454110\". Leave empty for all.", "items": { "type": "string" } }, "companySic": { "title": "🏷️ Company SIC codes", "type": "array", "description": "Keep only leads whose company matches these SIC industry codes, e.g. \"5961\". Leave empty for all.", "items": { "type": "string" } }, "minEmployees": { "title": "👥 Min company size (employees)", "minimum": 1, "type": "integer", "description": "Keep only leads whose company has at least this many employees. Leave empty for no lower bound." }, "maxEmployees": { "title": "👥 Max company size (employees)", "minimum": 1, "type": "integer", "description": "Keep only leads whose company has at most this many employees. Leave empty for no upper bound." }, "minRevenue": { "title": "💰 Min company revenue (USD)", "minimum": 0, "type": "integer", "description": "Keep only leads whose company has at least this much annual revenue in USD. Leave empty for no lower bound." }, "maxRevenue": { "title": "💰 Max company revenue (USD)", "minimum": 0, "type": "integer", "description": "Keep only leads whose company has at most this much annual revenue in USD. Leave empty for no upper bound." }, "companyFundingType": { "title": "🏦 Company funding stage", "type": "array", "description": "Keep only leads whose company raised these funding types. Leave empty for all.", "items": { "type": "string", "enum": [ "pre_seed", "seed", "angel", "venture", "series_a", "series_b", "series_c", "series_d", "series_e", "series_f", "debt", "grant", "equity", "convertible_note", "private_equity", "ipo", "post_ipo", "series_unknown", "undisclosed" ] } }, "findEmail": { "title": "📧 Find business email ($)", "type": "boolean", "description": "⚠️ THIS ADDS COST. When enabled, each returned lead also includes a real-time, real-time verified business email, billed as a SEPARATE paid event for every email found (on top of the per-lead charge). You are charged ONLY when an email is actually found, leads without a verifiable email are free. Available on PAID Apify plans only (a free-tier run with this on is rejected without charge). Leave OFF unless you specifically want emails.", "default": false }, "includeCompanyDetails": { "title": "🏢 Enrich full company details ($)", "type": "boolean", "description": "⚠️ THIS ADDS COST. When enabled, each returned lead that has a current company also includes the FULL firmographic record for that company (funding rounds, every office location, complete tech stack, industries, revenue band) in a top-level company_details field, billed as a SEPARATE paid event per lead that returns a company. Leads with no company are free. Leave OFF unless you want firmographics.", "default": false } } }, "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 } } } } } } } } } }