> ## Documentation Index > Fetch the complete documentation index at: https://doc.bettercontact.rocks/llms.txt > Use this file to discover all available pages before exploring further. # New Lead Finder Search > Find new leads based on Company and People criteria. ## OpenAPI ````yaml POST /lead_finder/async openapi: 3.0.1 info: title: BetterContact API description: The official BetterContact API to enrich your contacts list and find leads license: name: MIT version: 1.0.0 servers: - url: https://app.bettercontact.rocks/api/v2 security: - apiKey: [] paths: /lead_finder/async: post: description: >- Create a new lead finder request to find people working in specific companies parameters: [] requestBody: description: Filters and parameters for lead finding required: true content: application/json: schema: $ref: '#/components/schemas/LeadFinderRequest' responses: '201': description: Lead finder request accepted content: application/json: schema: type: object properties: success: type: boolean example: true message: type: string example: Lead finder request accepted. request_id: type: string example: bc39ffbfc24cf043b748 '401': description: Not authorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedError' security: - apiKey: [] components: schemas: LeadFinderRequest: type: object properties: filters: $ref: '#/components/schemas/LeadFinderFilters' limit: type: integer minimum: 1 maximum: 200 description: >- Maximum number of results to return per request. Accepted values between 1 and 200. By default, up to 100 leads are returned example: 100 offset: type: integer description: >- Number of results to skip before returning matches. Use this to paginate through results when the total number of leads found (visible in the `leads_found` attribute of the response) exceeds the `limit` of the current request. For example, if `leads_found` is 350 and `limit` is 100, set `offset` to 101 to retrieve the next page of results. example: 101 webhook: type: string nullable: true description: Optional URL to receive results automatically required: - filters UnauthorizedError: type: object properties: error: type: string example: Unauthorized LeadFinderFilters: type: object properties: company: $ref: '#/components/schemas/CompanyDomainFilter' company_industry: $ref: '#/components/schemas/CompanyIndustryFilter' company_technology: $ref: '#/components/schemas/FilterObject' company_headcount_min: type: integer minimum: 1 maximum: 10000000 description: Minimum employee count company_headcount_max: type: integer minimum: 1 maximum: 10000000 description: Maximum employee count lead_fullname: $ref: '#/components/schemas/FilterObject' lead_linkedin_url: $ref: '#/components/schemas/FilterObject' lead_department: $ref: '#/components/schemas/LeadDepartmentFilter' lead_function: $ref: '#/components/schemas/LeadFunctionFilter' lead_skills: $ref: '#/components/schemas/FilterObject' lead_job_title: $ref: '#/components/schemas/JobTitleFilter' lead_location: $ref: '#/components/schemas/FilterObject' lead_seniority: $ref: '#/components/schemas/SeniorityFilter' CompanyDomainFilter: type: object properties: include: type: array items: type: string nullable: true description: Company domains that must match (e.g. 'google.com', 'microsoft.com') exclude: type: array items: type: string nullable: true description: >- Company domains that must NOT match (e.g. 'google.com', 'microsoft.com') CompanyIndustryFilter: type: object properties: include: type: array items: type: string enum: - it services and it consulting - software development - hospitals and health care - financial services - higher education - retail - government administration - banking - construction - business consulting and services - real estate - motor vehicle manufacturing - insurance - truck transportation - advertising services - telecommunications - education administration programs - non-profit organizations - oil and gas - pharmaceutical manufacturing - manufacturing - hospitality - food and beverage services - law practice - industrial machinery manufacturing - utilities - appliances, electrical, and electronics manufacturing - food and beverage manufacturing - wellness and fitness services - research services - primary and secondary education - chemical manufacturing - machinery manufacturing - staffing and recruiting - medical equipment manufacturing - airlines and aviation - defense and space manufacturing - mining - biotechnology research - restaurants - environmental services - accounting - retail apparel and fashion - entertainment providers - civil engineering - wholesale building materials - wholesale - aviation and aerospace component manufacturing - travel arrangements - automation machinery manufacturing - human resources services - renewable energy semiconductor manufacturing - architecture and planning - outsourcing and offshoring consulting - facilities services - semiconductor manufacturing - civic and social organizations - spectator sports - armed forces - design services - consumer services - professional training and coaching - individual and family services - broadcast media production and distribution - mental health care - personal care product manufacturing - farming - technology, information and internet - computers and electronics manufacturing - security and investigations - international trade and development - transportation, logistics, supply chain and storage - media production - events services - medical practices - information services - e-learning providers - computer and network security - packaging and containers manufacturing - textile manufacturing - retail luxury goods and jewelry - furniture and home furnishings manufacturing - book and periodical publishing - law enforcement - computer games - plastics manufacturing - computer hardware manufacturing - public safety - musicians - beverage manufacturing - printing services - public relations and communications services - paper and forest product manufacturing - retail office equipment - venture capital and private equity principals - religious institutions - international affairs - government relations services - freight and package transportation - museums, historical sites, and zoos - market research - newspaper publishing - gambling facilities and casinos - online audio and video media - executive offices - administration of justice - investment banking - legal services - performing arts - glass, ceramics and concrete manufacturing - photography - recreational facilities - graphic design - translation and localization - shipbuilding - maritime transportation - political organizations - artists and writers - animation and post-production - investment management - wholesale import and export - libraries - sporting goods manufacturing - think tanks - railroad equipment manufacturing - writing and editing - veterinary services - retail groceries - fundraising - alternative medicine - leasing non-residential real estate - tobacco manufacturing - movies, videos, and sound - legislative offices - retail art supplies - public policy offices - computer networking products - warehousing and storage - fisheries - philanthropic fundraising services - nanotechnology research - strategic management services - capital markets - dairy product manufacturing - ranching - wireless services - alternative dispute resolution - mobile gaming apps nullable: true description: >- Company industries that must match. Must be exact values from the predefined list. exclude: type: array items: type: string enum: - it services and it consulting - software development - hospitals and health care - financial services - higher education - retail - government administration - banking - construction - business consulting and services - real estate - motor vehicle manufacturing - insurance - truck transportation - advertising services - telecommunications - education administration programs - non-profit organizations - oil and gas - pharmaceutical manufacturing - manufacturing - hospitality - food and beverage services - law practice - industrial machinery manufacturing - utilities - appliances, electrical, and electronics manufacturing - food and beverage manufacturing - wellness and fitness services - research services - primary and secondary education - chemical manufacturing - machinery manufacturing - staffing and recruiting - medical equipment manufacturing - airlines and aviation - defense and space manufacturing - mining - biotechnology research - restaurants - environmental services - accounting - retail apparel and fashion - entertainment providers - civil engineering - wholesale building materials - wholesale - aviation and aerospace component manufacturing - travel arrangements - automation machinery manufacturing - human resources services - renewable energy semiconductor manufacturing - architecture and planning - outsourcing and offshoring consulting - facilities services - semiconductor manufacturing - civic and social organizations - spectator sports - armed forces - design services - consumer services - professional training and coaching - individual and family services - broadcast media production and distribution - mental health care - personal care product manufacturing - farming - technology, information and internet - computers and electronics manufacturing - security and investigations - international trade and development - transportation, logistics, supply chain and storage - media production - events services - medical practices - information services - e-learning providers - computer and network security - packaging and containers manufacturing - textile manufacturing - retail luxury goods and jewelry - furniture and home furnishings manufacturing - book and periodical publishing - law enforcement - computer games - plastics manufacturing - computer hardware manufacturing - public safety - musicians - beverage manufacturing - printing services - public relations and communications services - paper and forest product manufacturing - retail office equipment - venture capital and private equity principals - religious institutions - international affairs - government relations services - freight and package transportation - museums, historical sites, and zoos - market research - newspaper publishing - gambling facilities and casinos - online audio and video media - executive offices - administration of justice - investment banking - legal services - performing arts - glass, ceramics and concrete manufacturing - photography - recreational facilities - graphic design - translation and localization - shipbuilding - maritime transportation - political organizations - artists and writers - animation and post-production - investment management - wholesale import and export - libraries - sporting goods manufacturing - think tanks - railroad equipment manufacturing - writing and editing - veterinary services - retail groceries - fundraising - alternative medicine - leasing non-residential real estate - tobacco manufacturing - movies, videos, and sound - legislative offices - retail art supplies - public policy offices - computer networking products - warehousing and storage - fisheries - philanthropic fundraising services - nanotechnology research - strategic management services - capital markets - dairy product manufacturing - ranching - wireless services - alternative dispute resolution - mobile gaming apps nullable: true description: >- Company industries that must NOT match. Must be exact values from the predefined list. FilterObject: type: object properties: include: type: array items: type: string nullable: true description: Values that must match exclude: type: array items: type: string nullable: true description: Values that must NOT match LeadDepartmentFilter: type: object properties: include: type: array items: type: string enum: - operations - executive - sales - engineering_technical - founder - teacher - office_operations - technician - customer_service_support - project_management - finance - information_technology - operations_executive - consultant - store_operations - all_design - software_development - professor - medicine - support_technical_services - marketing - construction - logistics - business_development - accounting - legal - human_resources - finance_executive - account_management - principal - research_development - financial_planning_analysis - nursing - graphic_design - quality_assurance - sales_operations - data_science - facilities_management - medical_administration - compliance - sales_executive - legal_operations - industrial_engineering - governmental_affairs_regulatory_law - it_operations - doctors_physicians - real_estate - social_work - information_security - application_development - digital_marketing - sourcing_procurement - marketing_communications - medical_education_training - health_safety - psychology - recruiting_talent_acquisition - learning_development - infrastructure - corporate_strategy - test_quality_assurance - help_desk_desktop_services - information_technology_executive - customer_success - internal_audit_control - supply_chain - web_development - marketing_operations - product_mangement - product_development - it_strategy - safety - business_intelligence - content_marketing - legal_executive - public_relations - enterprise_architecture - enterprise_resource_planning - social_media_marketing - field_outside_sales - project_program_management - artificial_intelligence_machine_learning - networking - quality_management - chemical_engineering - sales_engineering - physical_security - talent_management - physical_therapy - technology_operations - product_ui_ux_design - medical_health_executive - emerging_technology_innovation - ui_ux - marketing_executive - brand_management - pharmacy - digital_transformation - call_center - medical_research - project_development - public_health - search_engine_optimization_pay_per_click - governance - first_responder - event_marketing - strategic_communications - mechanic - compensation_benefits - customer_experience - mergers_acquisitions - tax - cloud_mobility - database_administration - dentistry - hr_business_partner - shared_services - advertising - partnerships - telecommunications - devops - pathology - financial_risk - legal_counsel - marketing_analytics_insights - lawyer_attorney - nutrition_dietetics - inside_sales - investor_relations - superintendent - servers - mobile_development - ecommerce_development - sales_training - organizational_development - product_marketing - contracts - employee_labor_relations - business_service_management_itsm - radiology - real_estate_finance - human_resource_information_system - human_resources_executive - corporate_secretary - field_marketing - ecommerce_marketing - scrum_master_agile_coach - pediatrics - it_audit_it_compliance - treasury - litigation - data_center - people_operations - clinical_systems - culture_diversity_inclusion - financial_reporting - leasing - it_training - lead_generation - demand_generation - revenue_operations - customer_retention_development - it_asset_management - it_procurement - channel_sales - data_warehouse - oncology - hr_financial_erp_systems - financial_strategy - financial_systems - opthalmology - anesthesiology - psychiatry - orthopedics - bioengineering - obstetrics_gynecology - optometry - intellectual_property_patent - neurology - labor_employment - acquisitions - sales_enablement - dermatology - workforce_mangement - chiropractics - retail_store_systems - customer_marketing - storage_disaster_recovery - technical_marketing - privacy - ediscovery - virtualization - epidemiology - infectious_disease - ethics - biometrics - collaboration_web_app nullable: true description: >- Lead departments that must match. Must be exact values from the predefined list. exclude: type: array items: type: string enum: - operations - executive - sales - engineering_technical - founder - teacher - office_operations - technician - customer_service_support - project_management - finance - information_technology - operations_executive - consultant - store_operations - all_design - software_development - professor - medicine - support_technical_services - marketing - construction - logistics - business_development - accounting - legal - human_resources - finance_executive - account_management - principal - research_development - financial_planning_analysis - nursing - graphic_design - quality_assurance - sales_operations - data_science - facilities_management - medical_administration - compliance - sales_executive - legal_operations - industrial_engineering - governmental_affairs_regulatory_law - it_operations - doctors_physicians - real_estate - social_work - information_security - application_development - digital_marketing - sourcing_procurement - marketing_communications - medical_education_training - health_safety - psychology - recruiting_talent_acquisition - learning_development - infrastructure - corporate_strategy - test_quality_assurance - help_desk_desktop_services - information_technology_executive - customer_success - internal_audit_control - supply_chain - web_development - marketing_operations - product_mangement - product_development - it_strategy - safety - business_intelligence - content_marketing - legal_executive - public_relations - enterprise_architecture - enterprise_resource_planning - social_media_marketing - field_outside_sales - project_program_management - artificial_intelligence_machine_learning - networking - quality_management - chemical_engineering - sales_engineering - physical_security - talent_management - physical_therapy - technology_operations - product_ui_ux_design - medical_health_executive - emerging_technology_innovation - ui_ux - marketing_executive - brand_management - pharmacy - digital_transformation - call_center - medical_research - project_development - public_health - search_engine_optimization_pay_per_click - governance - first_responder - event_marketing - strategic_communications - mechanic - compensation_benefits - customer_experience - mergers_acquisitions - tax - cloud_mobility - database_administration - dentistry - hr_business_partner - shared_services - advertising - partnerships - telecommunications - devops - pathology - financial_risk - legal_counsel - marketing_analytics_insights - lawyer_attorney - nutrition_dietetics - inside_sales - investor_relations - superintendent - servers - mobile_development - ecommerce_development - sales_training - organizational_development - product_marketing - contracts - employee_labor_relations - business_service_management_itsm - radiology - real_estate_finance - human_resource_information_system - human_resources_executive - corporate_secretary - field_marketing - ecommerce_marketing - scrum_master_agile_coach - pediatrics - it_audit_it_compliance - treasury - litigation - data_center - people_operations - clinical_systems - culture_diversity_inclusion - financial_reporting - leasing - it_training - lead_generation - demand_generation - revenue_operations - customer_retention_development - it_asset_management - it_procurement - channel_sales - data_warehouse - oncology - hr_financial_erp_systems - financial_strategy - financial_systems - opthalmology - anesthesiology - psychiatry - orthopedics - bioengineering - obstetrics_gynecology - optometry - intellectual_property_patent - neurology - labor_employment - acquisitions - sales_enablement - dermatology - workforce_mangement - chiropractics - retail_store_systems - customer_marketing - storage_disaster_recovery - technical_marketing - privacy - ediscovery - virtualization - epidemiology - infectious_disease - ethics - biometrics - collaboration_web_app nullable: true description: >- Lead departments that must NOT match. Must be exact values from the predefined list. LeadFunctionFilter: type: object properties: include: type: array items: type: string enum: - operations - support - engineering - sales - education - information_technology - finance - entrepreneurship - administrative - consulting - marketing - arts_and_design - product_management - human_resources - legal - business_development - media_and_communication - data_science - accounting nullable: true description: >- Lead functions that must match. Must be exact values from the predefined list. exclude: type: array items: type: string enum: - operations - support - engineering - sales - education - information_technology - finance - entrepreneurship - administrative - consulting - marketing - arts_and_design - product_management - human_resources - legal - business_development - media_and_communication - data_science - accounting nullable: true description: >- Lead functions that must NOT match. Must be exact values from the predefined list. JobTitleFilter: allOf: - $ref: '#/components/schemas/FilterObject' - type: object properties: exact_match: type: boolean description: When enabled, only exact job title matches are returned SeniorityFilter: type: object properties: include: type: array items: type: string enum: - senior - entry - manager - mid-level - director - c_suite - owner - intern - founder - head - vp - partner nullable: true description: >- Seniority levels that must match. Possible values: senior, entry, manager, mid-level, director, c_suite, owner, intern, founder, head, vp, partner exclude: type: array items: type: string enum: - senior - entry - manager - mid-level - director - c_suite - owner - intern - founder - head - vp - partner nullable: true description: >- Seniority levels that must NOT match. Possible values: senior, entry, manager, mid-level, director, c_suite, owner, intern, founder, head, vp, partner securitySchemes: apiKey: type: apiKey in: header name: X-API-Key ````