> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendpilot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Lead Database Search

> Create a new lead database search to find leads matching your criteria

Initiates a bulk search in the Lead Database to find leads matching your specified filters. The API supports 120+ filters across multiple categories for precise lead targeting.

## Request

<ParamField header="X-API-Key" type="string" required>
  Your API key
</ParamField>

## Request Body

<ParamField body="name" type="string" required>
  A name for this search (for your reference)
</ParamField>

<ParamField body="limit" type="number" required>
  Maximum number of leads to find (1-10000)
</ParamField>

<ParamField body="filters" type="object" required>
  Search filters to match leads. All filters are optional - combine as needed.
</ParamField>

<ParamField body="webhook_url" type="string">
  Optional URL to receive webhook when search completes
</ParamField>

***

## Filter Categories

### Person Filters

<ParamField body="filters.name" type="string">
  Free-text search by person name
</ParamField>

<ParamField body="filters.jobTitles" type="string[]">
  Job titles to include (e.g., `["CEO", "CTO", "Founder"]`)
</ParamField>

<ParamField body="filters.excludeJobTitles" type="string[]">
  Job titles to exclude
</ParamField>

<ParamField body="filters.skills" type="string[]">
  Professional skills to include (e.g., `["Python", "Machine Learning"]`)
</ParamField>

<ParamField body="filters.excludeSkills" type="string[]">
  Professional skills to exclude
</ParamField>

<ParamField body="filters.languages" type="string[]">
  Languages spoken (e.g., `["English", "Spanish"]`)
</ParamField>

<ParamField body="filters.excludeLanguages" type="string[]">
  Languages to exclude
</ParamField>

<ParamField body="filters.languageProficiency" type="string[]">
  Language proficiency levels (e.g., `["Native", "Fluent"]`)
</ParamField>

<ParamField body="filters.excludeLanguageProficiency" type="string[]">
  Language proficiency levels to exclude
</ParamField>

<ParamField body="filters.linkedinUsernames" type="string[]">
  LinkedIn usernames or profile URLs to include
</ParamField>

<ParamField body="filters.excludeLinkedinUsernames" type="string[]">
  LinkedIn usernames or profile URLs to exclude
</ParamField>

<ParamField body="filters.locations" type="string[]">
  Locations/countries to include (e.g., `["United States", "Canada"]`)
</ParamField>

<ParamField body="filters.excludeLocations" type="string[]">
  Locations/countries to exclude
</ParamField>

<ParamField body="filters.summaryKeywords" type="string[]">
  Keywords to search in profile summaries
</ParamField>

<ParamField body="filters.excludeSummaryKeywords" type="string[]">
  Keywords to exclude from profile summaries
</ParamField>

<ParamField body="filters.seniority" type="string[]">
  Seniority levels (e.g., `["C-Level", "Director", "VP", "Manager"]`)
</ParamField>

<ParamField body="filters.excludeSeniority" type="string[]">
  Seniority levels to exclude
</ParamField>

<ParamField body="filters.departments" type="string[]">
  Standard departments (e.g., `["Engineering", "Sales", "Marketing"]`)
</ParamField>

<ParamField body="filters.excludeDepartments" type="string[]">
  Departments to exclude
</ParamField>

<ParamField body="filters.experimentalDepartments" type="string[]">
  Experimental/emerging department classifications
</ParamField>

<ParamField body="filters.excludeExperimentalDepartments" type="string[]">
  Experimental departments to exclude
</ParamField>

<ParamField body="filters.certifications" type="string[]">
  Professional certifications (e.g., `["PMP", "AWS Certified"]`)
</ParamField>

<ParamField body="filters.excludeCertifications" type="string[]">
  Certifications to exclude
</ParamField>

***

### Experience Filters

<ParamField body="filters.minTotalExperience" type="number">
  Minimum total professional experience in months
</ParamField>

<ParamField body="filters.maxTotalExperience" type="number">
  Maximum total professional experience in months
</ParamField>

<ParamField body="filters.minCurrentJobDuration" type="number">
  Minimum duration at current job in months
</ParamField>

<ParamField body="filters.maxCurrentJobDuration" type="number">
  Maximum duration at current job in months
</ParamField>

***

### Education Filters

<ParamField body="filters.institutions" type="string[]">
  Educational institutions (e.g., `["Stanford University", "MIT"]`)
</ParamField>

<ParamField body="filters.excludeInstitutions" type="string[]">
  Institutions to exclude
</ParamField>

<ParamField body="filters.majors" type="string[]">
  Fields of study/majors (e.g., `["Computer Science", "Business"]`)
</ParamField>

<ParamField body="filters.excludeMajors" type="string[]">
  Majors to exclude
</ParamField>

<ParamField body="filters.educationKeywords" type="string[]">
  Keywords to search in education history
</ParamField>

<ParamField body="filters.excludeEducationKeywords" type="string[]">
  Education keywords to exclude
</ParamField>

***

### Company Filters

<ParamField body="filters.companies" type="string[]">
  Company names to include (e.g., `["Google", "Microsoft"]`)
</ParamField>

<ParamField body="filters.excludeCompanies" type="string[]">
  Company names to exclude
</ParamField>

<ParamField body="filters.companyDomains" type="string[]">
  Company domains, comma-separated (e.g., `["google.com", "microsoft.com"]`)
</ParamField>

<ParamField body="filters.excludeCompanyDomains" type="string[]">
  Company domains to exclude
</ParamField>

<ParamField body="filters.companyLinkedinUsernames" type="string[]">
  Company LinkedIn usernames/URLs
</ParamField>

<ParamField body="filters.excludeCompanyLinkedinUsernames" type="string[]">
  Company LinkedIn usernames to exclude
</ParamField>

<ParamField body="filters.companyTypes" type="string[]">
  Company types (e.g., `["Public", "Private", "Non-Profit"]`)
</ParamField>

<ParamField body="filters.excludeCompanyTypes" type="string[]">
  Company types to exclude
</ParamField>

<ParamField body="filters.industries" type="string[]">
  Industries (e.g., `["Technology", "Healthcare", "Finance"]`)
</ParamField>

<ParamField body="filters.excludeIndustries" type="string[]">
  Industries to exclude
</ParamField>

<ParamField body="filters.experimentalIndustries" type="string[]">
  Experimental/emerging industry classifications
</ParamField>

<ParamField body="filters.excludeExperimentalIndustries" type="string[]">
  Experimental industries to exclude
</ParamField>

<ParamField body="filters.hqLocations" type="string[]">
  Company headquarters locations (e.g., `["San Francisco", "New York"]`)
</ParamField>

<ParamField body="filters.excludeHqLocations" type="string[]">
  HQ locations to exclude
</ParamField>

<ParamField body="filters.companySizes" type="string[]">
  Company size ranges (e.g., `["11-50", "51-200", "201-500"]`)
</ParamField>

<ParamField body="filters.excludeCompanySizes" type="string[]">
  Company sizes to exclude
</ParamField>

<ParamField body="filters.companyStatus" type="string">
  Company status: `active` or `closed`
</ParamField>

<ParamField body="filters.statusComments" type="string[]">
  Status comments to filter by
</ParamField>

<ParamField body="filters.publiclyListed" type="boolean">
  Filter for publicly listed companies only
</ParamField>

<ParamField body="filters.b2b" type="boolean">
  Filter for B2B companies only
</ParamField>

***

### Industry Codes

<ParamField body="filters.sicCodes" type="string[]">
  SIC (Standard Industrial Classification) codes
</ParamField>

<ParamField body="filters.excludeSicCodes" type="string[]">
  SIC codes to exclude
</ParamField>

<ParamField body="filters.naicsCodes" type="string[]">
  NAICS (North American Industry Classification System) codes
</ParamField>

<ParamField body="filters.excludeNaicsCodes" type="string[]">
  NAICS codes to exclude
</ParamField>

<ParamField body="filters.keywords" type="string[]">
  General keywords to search for
</ParamField>

<ParamField body="filters.excludeKeywords" type="string[]">
  Keywords to exclude
</ParamField>

***

### Funding Filters

<ParamField body="filters.lastFundingDateRange" type="string">
  Last funding date range: `30`, `60`, `90`, or `90+` (days)
</ParamField>

<ParamField body="filters.fundingRoundNames" type="string[]">
  Funding round names (e.g., `["Series A", "Series B", "Seed"]`)
</ParamField>

<ParamField body="filters.ownershipStatus" type="string">
  Ownership status filter
</ParamField>

<ParamField body="filters.minFundingAmount" type="number">
  Minimum total funding amount (USD)
</ParamField>

<ParamField body="filters.maxFundingAmount" type="number">
  Maximum total funding amount (USD)
</ParamField>

<ParamField body="filters.ipoStartDate" type="string">
  IPO date range start (ISO 8601 format)
</ParamField>

<ParamField body="filters.ipoEndDate" type="string">
  IPO date range end (ISO 8601 format)
</ParamField>

<ParamField body="filters.acquisitionStartDate" type="string">
  Acquisition date range start (ISO 8601 format)
</ParamField>

<ParamField body="filters.acquisitionEndDate" type="string">
  Acquisition date range end (ISO 8601 format)
</ParamField>

<ParamField body="filters.minAnnualRevenue" type="number">
  Minimum annual revenue (USD)
</ParamField>

<ParamField body="filters.maxAnnualRevenue" type="number">
  Maximum annual revenue (USD)
</ParamField>

***

### Website Analytics Filters

<ParamField body="filters.minMonthlyVisits" type="number">
  Minimum monthly website visits
</ParamField>

<ParamField body="filters.maxMonthlyVisits" type="number">
  Maximum monthly website visits
</ParamField>

<ParamField body="filters.minGlobalRanking" type="number">
  Minimum global website ranking
</ParamField>

<ParamField body="filters.maxGlobalRanking" type="number">
  Maximum global website ranking
</ParamField>

<ParamField body="filters.minCountryRanking" type="number">
  Minimum country-specific ranking
</ParamField>

<ParamField body="filters.maxCountryRanking" type="number">
  Maximum country-specific ranking
</ParamField>

<ParamField body="filters.minCategoryRanking" type="number">
  Minimum category ranking
</ParamField>

<ParamField body="filters.maxCategoryRanking" type="number">
  Maximum category ranking
</ParamField>

<ParamField body="filters.minBounceRate" type="number">
  Minimum bounce rate percentage (0-100)
</ParamField>

<ParamField body="filters.maxBounceRate" type="number">
  Maximum bounce rate percentage (0-100)
</ParamField>

<ParamField body="filters.minPagesPerVisit" type="number">
  Minimum pages per visit
</ParamField>

<ParamField body="filters.maxPagesPerVisit" type="number">
  Maximum pages per visit
</ParamField>

<ParamField body="filters.minVisitDuration" type="number">
  Minimum visit duration in seconds
</ParamField>

<ParamField body="filters.maxVisitDuration" type="number">
  Maximum visit duration in seconds
</ParamField>

<ParamField body="filters.websiteTopics" type="string[]">
  Website topics to include
</ParamField>

<ParamField body="filters.excludeWebsiteTopics" type="string[]">
  Website topics to exclude
</ParamField>

***

### Technology Filters

<ParamField body="filters.technologies" type="string[]">
  Technologies used (e.g., `["React", "AWS", "Salesforce"]`)
</ParamField>

<ParamField body="filters.excludeTechnologies" type="string[]">
  Technologies to exclude
</ParamField>

<ParamField body="filters.hasPricing" type="boolean">
  Company has public pricing page
</ParamField>

<ParamField body="filters.hasDemo" type="boolean">
  Company offers product demos
</ParamField>

<ParamField body="filters.hasDocumentation" type="boolean">
  Company has public documentation
</ParamField>

<ParamField body="filters.hasFreeTrial" type="boolean">
  Company offers free trials
</ParamField>

<ParamField body="filters.hasDownloads" type="boolean">
  Company offers downloadable products
</ParamField>

<ParamField body="filters.hasMobileApps" type="boolean">
  Company has mobile applications
</ParamField>

<ParamField body="filters.hasOnlineReviews" type="boolean">
  Company has online reviews
</ParamField>

***

### Job Posting Filters

<ParamField body="filters.jobPostingTitles" type="string[]">
  Job titles being recruited (e.g., `["Software Engineer", "Sales Manager"]`)
</ParamField>

<ParamField body="filters.excludeJobPostingTitles" type="string[]">
  Job posting titles to exclude
</ParamField>

<ParamField body="filters.jobPostingLocations" type="string[]">
  Job posting locations
</ParamField>

<ParamField body="filters.excludeJobPostingLocations" type="string[]">
  Job posting locations to exclude
</ParamField>

<ParamField body="filters.jobPostingFunctions" type="string[]">
  Job functions being recruited
</ParamField>

<ParamField body="filters.excludeJobPostingFunctions" type="string[]">
  Job functions to exclude
</ParamField>

<ParamField body="filters.jobPostingStartDate" type="string">
  Job posting date range start (ISO 8601 format)
</ParamField>

<ParamField body="filters.jobPostingEndDate" type="string">
  Job posting date range end (ISO 8601 format)
</ParamField>

<ParamField body="filters.jobPostingEmploymentType" type="string">
  Employment type (e.g., `Full-time`, `Part-time`, `Contract`)
</ParamField>

<ParamField body="filters.jobPostingSeniority" type="string">
  Job posting seniority level
</ParamField>

***

### Recommendation Filters

<ParamField body="filters.recommendationKeywords" type="string[]">
  Keywords in LinkedIn recommendations
</ParamField>

<ParamField body="filters.excludeRecommendationKeywords" type="string[]">
  Recommendation keywords to exclude
</ParamField>

<ParamField body="filters.recommenderLinkedinUsernames" type="string[]">
  LinkedIn usernames of recommenders
</ParamField>

<ParamField body="filters.excludeRecommenderLinkedinUsernames" type="string[]">
  Recommender usernames to exclude
</ParamField>

<ParamField body="filters.minEmployeeSatisfaction" type="number">
  Minimum employee satisfaction score
</ParamField>

<ParamField body="filters.maxEmployeeSatisfaction" type="number">
  Maximum employee satisfaction score
</ParamField>

***

### Intent Filters

<ParamField body="filters.bomboraIntentTopics" type="string[]">
  Bombora intent topics (e.g., `["Cloud Computing", "CRM Software"]`)
</ParamField>

<ParamField body="filters.intentScoreRanges" type="string[]">
  Intent score ranges to filter by
</ParamField>

***

### News Filters

<ParamField body="filters.newsKeywords" type="string[]">
  Keywords in recent news articles
</ParamField>

<ParamField body="filters.excludeNewsKeywords" type="string[]">
  News keywords to exclude
</ParamField>

***

## Response

<ResponseField name="id" type="string">
  Unique identifier for the search
</ResponseField>

<ResponseField name="name" type="string">
  Name of the search
</ResponseField>

<ResponseField name="status" type="string">
  Current status: `pending`, `processing`, `completed`, `failed`
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the search was created
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.sendpilot.ai/v1/lead-database/searches" \
    -H "X-API-Key: your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Tech Founders Q1 2024",
      "limit": 100,
      "filters": {
        "jobTitles": ["CEO", "CTO", "Founder"],
        "locations": ["United States"],
        "industries": ["Technology", "Software"],
        "companySizes": ["11-50", "51-200"],
        "seniority": ["C-Level", "VP"],
        "minTotalExperience": 60,
        "technologies": ["AWS", "React"]
      }
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.sendpilot.ai/v1/lead-database/searches', {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.SENDPILOT_API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Tech Founders Q1 2024',
      limit: 100,
      filters: {
        jobTitles: ['CEO', 'CTO', 'Founder'],
        locations: ['United States'],
        industries: ['Technology', 'Software'],
        companySizes: ['11-50', '51-200'],
        seniority: ['C-Level', 'VP'],
        minTotalExperience: 60,
        technologies: ['AWS', 'React']
      }
    })
  });
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.sendpilot.ai/v1/lead-database/searches',
      headers={
          'X-API-Key': 'YOUR_API_KEY',
          'Content-Type': 'application/json'
      },
      json={
          'name': 'Tech Founders Q1 2024',
          'limit': 100,
          'filters': {
              'jobTitles': ['CEO', 'CTO', 'Founder'],
              'locations': ['United States'],
              'industries': ['Technology', 'Software'],
              'companySizes': ['11-50', '51-200'],
              'seniority': ['C-Level', 'VP'],
              'minTotalExperience': 60,
              'technologies': ['AWS', 'React']
          }
      }
  )
  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "search_abc123xyz",
    "name": "Tech Founders Q1 2024",
    "status": "pending",
    "created_at": "2024-02-24T10:30:00.000Z"
  }
  ```
</ResponseExample>

<Note>
  All filters are optional and can be combined. Use `exclude*` variants to explicitly remove matches. Array filters use OR logic within the same filter and AND logic across different filters.
</Note>


## OpenAPI

````yaml POST /v1/lead-database/searches
openapi: 3.0.0
info:
  title: SendPilot External API
  description: >
    The SendPilot API enables you to programmatically manage LinkedIn outreach
    campaigns,

    add leads, update lead statuses, send messages, and receive real-time
    webhook notifications.
  version: 1.0.0
  contact:
    name: SendPilot Support
    email: support@sendpilot.ai
    url: https://sendpilot.ai
servers:
  - url: https://api.sendpilot.ai
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Credits
    description: Credits and quota management
  - name: Campaigns
    description: Campaign management endpoints
  - name: Leads
    description: Lead management endpoints
  - name: Lead Database
    description: Lead Database search endpoints
  - name: Lead Extractor
    description: Lead extraction campaign endpoints
  - name: Inbox
    description: Direct messaging endpoints
paths:
  /v1/lead-database/searches:
    post:
      tags:
        - Lead Database
      summary: Create Lead Database Search
      description: Create a new lead database search to find leads matching your criteria
      operationId: createLeadDatabaseSearch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateLeadDatabaseSearchRequest'
      responses:
        '201':
          description: Search created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadDatabaseSearchResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    CreateLeadDatabaseSearchRequest:
      type: object
      properties:
        name:
          type: string
          description: A name for this search (for your reference)
        limit:
          type: integer
          minimum: 1
          maximum: 10000
          description: Maximum number of leads to find (1-10000)
        filters:
          $ref: '#/components/schemas/LeadDatabaseFilters'
        webhook_url:
          type: string
          format: uri
          description: Optional URL to receive webhook when search completes
      required:
        - name
        - limit
        - filters
    LeadDatabaseSearchResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the search
        name:
          type: string
          description: Name of the search
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
          description: Current status of the search
        created_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp when the search was created
      required:
        - id
        - name
        - status
        - created_at
    LeadDatabaseFilters:
      type: object
      description: Comprehensive filters for Lead Database search (120+ filters available)
      properties:
        name:
          type: string
          description: Free-text search by person name
        jobTitles:
          type: array
          items:
            type: string
          description: Job titles to include
        excludeJobTitles:
          type: array
          items:
            type: string
          description: Job titles to exclude
        skills:
          type: array
          items:
            type: string
          description: Professional skills to include
        excludeSkills:
          type: array
          items:
            type: string
          description: Professional skills to exclude
        languages:
          type: array
          items:
            type: string
          description: Languages spoken
        excludeLanguages:
          type: array
          items:
            type: string
          description: Languages to exclude
        languageProficiency:
          type: array
          items:
            type: string
          description: Language proficiency levels
        excludeLanguageProficiency:
          type: array
          items:
            type: string
          description: Language proficiency levels to exclude
        linkedinUsernames:
          type: array
          items:
            type: string
          description: LinkedIn usernames or profile URLs to include
        excludeLinkedinUsernames:
          type: array
          items:
            type: string
          description: LinkedIn usernames or profile URLs to exclude
        locations:
          type: array
          items:
            type: string
          description: Locations/countries to include
        excludeLocations:
          type: array
          items:
            type: string
          description: Locations/countries to exclude
        summaryKeywords:
          type: array
          items:
            type: string
          description: Keywords to search in profile summaries
        excludeSummaryKeywords:
          type: array
          items:
            type: string
          description: Keywords to exclude from profile summaries
        seniority:
          type: array
          items:
            type: string
          description: Seniority levels (C-Level, Director, VP, Manager, etc.)
        excludeSeniority:
          type: array
          items:
            type: string
          description: Seniority levels to exclude
        departments:
          type: array
          items:
            type: string
          description: Standard departments
        excludeDepartments:
          type: array
          items:
            type: string
          description: Departments to exclude
        experimentalDepartments:
          type: array
          items:
            type: string
          description: Experimental/emerging department classifications
        excludeExperimentalDepartments:
          type: array
          items:
            type: string
          description: Experimental departments to exclude
        certifications:
          type: array
          items:
            type: string
          description: Professional certifications
        excludeCertifications:
          type: array
          items:
            type: string
          description: Certifications to exclude
        minTotalExperience:
          type: integer
          description: Minimum total professional experience in months
        maxTotalExperience:
          type: integer
          description: Maximum total professional experience in months
        minCurrentJobDuration:
          type: integer
          description: Minimum duration at current job in months
        maxCurrentJobDuration:
          type: integer
          description: Maximum duration at current job in months
        institutions:
          type: array
          items:
            type: string
          description: Educational institutions
        excludeInstitutions:
          type: array
          items:
            type: string
          description: Institutions to exclude
        majors:
          type: array
          items:
            type: string
          description: Fields of study/majors
        excludeMajors:
          type: array
          items:
            type: string
          description: Majors to exclude
        educationKeywords:
          type: array
          items:
            type: string
          description: Keywords to search in education history
        excludeEducationKeywords:
          type: array
          items:
            type: string
          description: Education keywords to exclude
        companies:
          type: array
          items:
            type: string
          description: Company names to include
        excludeCompanies:
          type: array
          items:
            type: string
          description: Company names to exclude
        companyDomains:
          type: array
          items:
            type: string
          description: Company domains (comma-separated)
        excludeCompanyDomains:
          type: array
          items:
            type: string
          description: Company domains to exclude
        companyLinkedinUsernames:
          type: array
          items:
            type: string
          description: Company LinkedIn usernames/URLs
        excludeCompanyLinkedinUsernames:
          type: array
          items:
            type: string
          description: Company LinkedIn usernames to exclude
        companyTypes:
          type: array
          items:
            type: string
          description: Company types (Public, Private, Non-Profit, etc.)
        excludeCompanyTypes:
          type: array
          items:
            type: string
          description: Company types to exclude
        industries:
          type: array
          items:
            type: string
          description: Industries
        excludeIndustries:
          type: array
          items:
            type: string
          description: Industries to exclude
        experimentalIndustries:
          type: array
          items:
            type: string
          description: Experimental/emerging industry classifications
        excludeExperimentalIndustries:
          type: array
          items:
            type: string
          description: Experimental industries to exclude
        hqLocations:
          type: array
          items:
            type: string
          description: Company headquarters locations
        excludeHqLocations:
          type: array
          items:
            type: string
          description: HQ locations to exclude
        companySizes:
          type: array
          items:
            type: string
          description: Company size ranges (11-50, 51-200, 201-500, etc.)
        excludeCompanySizes:
          type: array
          items:
            type: string
          description: Company sizes to exclude
        companyStatus:
          type: string
          description: Company status (active or closed)
          enum:
            - active
            - closed
        statusComments:
          type: array
          items:
            type: string
          description: Status comments to filter by
        publiclyListed:
          type: boolean
          description: Filter for publicly listed companies only
        b2b:
          type: boolean
          description: Filter for B2B companies only
        sicCodes:
          type: array
          items:
            type: string
          description: SIC (Standard Industrial Classification) codes
        excludeSicCodes:
          type: array
          items:
            type: string
          description: SIC codes to exclude
        naicsCodes:
          type: array
          items:
            type: string
          description: NAICS (North American Industry Classification System) codes
        excludeNaicsCodes:
          type: array
          items:
            type: string
          description: NAICS codes to exclude
        keywords:
          type: array
          items:
            type: string
          description: General keywords to search for
        excludeKeywords:
          type: array
          items:
            type: string
          description: Keywords to exclude
        lastFundingDateRange:
          type: string
          description: Last funding date range (30, 60, 90, or 90+ days)
          enum:
            - '30'
            - '60'
            - '90'
            - 90+
        fundingRoundNames:
          type: array
          items:
            type: string
          description: Funding round names (Series A, Series B, Seed, etc.)
        ownershipStatus:
          type: string
          description: Ownership status filter
        minFundingAmount:
          type: number
          description: Minimum total funding amount (USD)
        maxFundingAmount:
          type: number
          description: Maximum total funding amount (USD)
        ipoStartDate:
          type: string
          format: date
          description: IPO date range start (ISO 8601 format)
        ipoEndDate:
          type: string
          format: date
          description: IPO date range end (ISO 8601 format)
        acquisitionStartDate:
          type: string
          format: date
          description: Acquisition date range start (ISO 8601 format)
        acquisitionEndDate:
          type: string
          format: date
          description: Acquisition date range end (ISO 8601 format)
        minAnnualRevenue:
          type: number
          description: Minimum annual revenue (USD)
        maxAnnualRevenue:
          type: number
          description: Maximum annual revenue (USD)
        minMonthlyVisits:
          type: integer
          description: Minimum monthly website visits
        maxMonthlyVisits:
          type: integer
          description: Maximum monthly website visits
        minGlobalRanking:
          type: integer
          description: Minimum global website ranking
        maxGlobalRanking:
          type: integer
          description: Maximum global website ranking
        minCountryRanking:
          type: integer
          description: Minimum country-specific ranking
        maxCountryRanking:
          type: integer
          description: Maximum country-specific ranking
        minCategoryRanking:
          type: integer
          description: Minimum category ranking
        maxCategoryRanking:
          type: integer
          description: Maximum category ranking
        minBounceRate:
          type: number
          description: Minimum bounce rate percentage (0-100)
        maxBounceRate:
          type: number
          description: Maximum bounce rate percentage (0-100)
        minPagesPerVisit:
          type: number
          description: Minimum pages per visit
        maxPagesPerVisit:
          type: number
          description: Maximum pages per visit
        minVisitDuration:
          type: integer
          description: Minimum visit duration in seconds
        maxVisitDuration:
          type: integer
          description: Maximum visit duration in seconds
        websiteTopics:
          type: array
          items:
            type: string
          description: Website topics to include
        excludeWebsiteTopics:
          type: array
          items:
            type: string
          description: Website topics to exclude
        technologies:
          type: array
          items:
            type: string
          description: Technologies used
        excludeTechnologies:
          type: array
          items:
            type: string
          description: Technologies to exclude
        hasPricing:
          type: boolean
          description: Company has public pricing page
        hasDemo:
          type: boolean
          description: Company offers product demos
        hasDocumentation:
          type: boolean
          description: Company has public documentation
        hasFreeTrial:
          type: boolean
          description: Company offers free trials
        hasDownloads:
          type: boolean
          description: Company offers downloadable products
        hasMobileApps:
          type: boolean
          description: Company has mobile applications
        hasOnlineReviews:
          type: boolean
          description: Company has online reviews
        jobPostingTitles:
          type: array
          items:
            type: string
          description: Job titles being recruited
        excludeJobPostingTitles:
          type: array
          items:
            type: string
          description: Job posting titles to exclude
        jobPostingLocations:
          type: array
          items:
            type: string
          description: Job posting locations
        excludeJobPostingLocations:
          type: array
          items:
            type: string
          description: Job posting locations to exclude
        jobPostingFunctions:
          type: array
          items:
            type: string
          description: Job functions being recruited
        excludeJobPostingFunctions:
          type: array
          items:
            type: string
          description: Job functions to exclude
        jobPostingStartDate:
          type: string
          format: date
          description: Job posting date range start (ISO 8601 format)
        jobPostingEndDate:
          type: string
          format: date
          description: Job posting date range end (ISO 8601 format)
        jobPostingEmploymentType:
          type: string
          description: Employment type (Full-time, Part-time, Contract)
        jobPostingSeniority:
          type: string
          description: Job posting seniority level
        recommendationKeywords:
          type: array
          items:
            type: string
          description: Keywords in LinkedIn recommendations
        excludeRecommendationKeywords:
          type: array
          items:
            type: string
          description: Recommendation keywords to exclude
        recommenderLinkedinUsernames:
          type: array
          items:
            type: string
          description: LinkedIn usernames of recommenders
        excludeRecommenderLinkedinUsernames:
          type: array
          items:
            type: string
          description: Recommender usernames to exclude
        minEmployeeSatisfaction:
          type: number
          description: Minimum employee satisfaction score
        maxEmployeeSatisfaction:
          type: number
          description: Maximum employee satisfaction score
        bomboraIntentTopics:
          type: array
          items:
            type: string
          description: Bombora intent topics
        intentScoreRanges:
          type: array
          items:
            type: string
          description: Intent score ranges to filter by
        newsKeywords:
          type: array
          items:
            type: string
          description: Keywords in recent news articles
        excludeNewsKeywords:
          type: array
          items:
            type: string
          description: News keywords to exclude
    Error:
      type: object
      properties:
        statusCode:
          type: integer
        error:
          type: string
        code:
          type: string
        message:
          type: string
      required:
        - statusCode
        - message
  responses:
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key for authentication

````