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

# Leads search

> Find leads by person, location, company, industry, tech stack, funding, traffic, hiring and HQ filters, optionally within one company. Returns name, job title, seniority, department, location, LinkedIn profile, skills and company details; paged up to 500,000 pages of 10–100 leads. 2 points per returned record.



## OpenAPI

````yaml /openapi.json post /functions/v1/run-leads-search
openapi: 3.0.0
info:
  title: NeuralVerge API
  version: 1.0.0
  description: >-
    NeuralVerge API for AI research, search, extraction, and structured data
    source execution.
servers:
  - url: https://api.neuralverge.ai
    description: NeuralVerge API
security:
  - BearerAuth: []
tags:
  - name: AI Research
    description: Multi-step research workflows and the sessions they run in.
  - name: AI Extract
    description: Schema-driven extraction workflows.
  - name: Search
    description: Fast, synchronous web search with no session or polling.
  - name: Company intelligence
    description: Company profile lookups from company databases.
  - name: E-commerce & Marketplaces
    description: >-
      Product, seller, and review lookups on Amazon, eBay, Walmart, AliExpress,
      and Alibaba.
  - name: Enrichment
    description: Email and phone enrichment, validation, and discovery.
  - name: Product reviews
    description: >-
      Software and business reviews from Capterra, Gartner Peer Insights, and
      Trustpilot.
  - name: Social media
    description: LinkedIn profile, company, and people lookups.
  - name: Company Registries
    description: Company Registries data sources.
  - name: Startup & Funding Data
    description: Startup & Funding Data data sources.
  - name: Maps & Local Businesses
    description: Maps & Local Businesses data sources.
  - name: B2B data
    description: >-
      People and company data for B2B: LinkedIn profiles and searches, company
      employees, ICP-ranked leads.
paths:
  /functions/v1/run-leads-search:
    post:
      tags:
        - B2B data
      summary: Leads search
      description: >-
        Find leads by person, location, company, industry, tech stack, funding,
        traffic, hiring and HQ filters, optionally within one company. Returns
        name, job title, seniority, department, location, LinkedIn profile,
        skills and company details; paged up to 500,000 pages of 10–100 leads. 2
        points per returned record.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                page_size:
                  description: Leads per page (10–100)
                  type: integer
                  minimum: 10
                  maximum: 100
                  default: 25
                page:
                  description: Page (up to 500000)
                  type: integer
                  minimum: 1
                  maximum: 500000
                  default: 1
                first_name:
                  description: 'Name: first'
                  type: string
                last_name:
                  description: 'Name: last'
                  type: string
                person_headline:
                  description: Headline (include). e.g. B2B, B2C, SaaS
                  type: array
                  items:
                    type: string
                exclude_person_headline:
                  description: Headline (exclude). e.g. B2B, B2C, SaaS
                  type: array
                  items:
                    type: string
                include_title:
                  description: Job Title (include)
                  type: array
                  items:
                    type: string
                exclude_title:
                  description: Job Title (exclude)
                  type: array
                  items:
                    type: string
                job_levels:
                  description: Seniority Level. e.g. C-Level, VP, Director
                  type: array
                  items:
                    type: string
                job_functions:
                  description: >-
                    Department. e.g. Advertising & Marketing, Art, Culture and
                    Creative Professionals, Construction
                  type: array
                  items:
                    type: string
                skills:
                  description: Skills
                  type: array
                  items:
                    type: string
                languages:
                  description: Languages
                  type: array
                  items:
                    type: string
                country:
                  description: Country. e.g. Afghanistan, Aland Islands, Albania
                  type: array
                  items:
                    type: string
                continent:
                  description: Continent. e.g. Africa, Antarctica, Asia
                  type: array
                  items:
                    type: string
                state:
                  description: State / Province. e.g. Alabama, Alaska, Alberta
                  type: array
                  items:
                    type: string
                city:
                  description: City
                  type: array
                  items:
                    type: string
                company_linkedin_url:
                  description: >-
                    Company LinkedIn URL. e.g.
                    https://www.linkedin.com/company/stripe
                  type: string
                company_name:
                  description: Company Name
                  type: array
                  items:
                    type: string
                company_name_fuzzy:
                  description: 'Company Name: fuzzy match'
                  type: boolean
                company_headline:
                  description: Headline (include). e.g. B2B, B2C, SaaS
                  type: array
                  items:
                    type: string
                exclude_company_headline:
                  description: Headline (exclude). e.g. B2B, B2C, SaaS
                  type: array
                  items:
                    type: string
                company_overview:
                  description: Company Overview (include). e.g. B2B, B2C, SaaS
                  type: array
                  items:
                    type: string
                exclude_company_overview:
                  description: Company Overview (exclude). e.g. B2B, B2C, SaaS
                  type: array
                  items:
                    type: string
                domain:
                  description: Domain (include)
                  type: array
                  items:
                    type: string
                exclude_domain:
                  description: Domain (exclude)
                  type: array
                  items:
                    type: string
                employees_min:
                  description: 'Employees: minimum'
                  type: integer
                  minimum: 0
                employees_max:
                  description: 'Employees: maximum'
                  type: integer
                  minimum: 0
                revenue:
                  description: Revenue. e.g. $100M to <$1B, $10M to <$50M, $1B+
                  type: array
                  items:
                    type: string
                naics_industry:
                  description: >-
                    NAICS Industry. North American Industry Classification
                    System — standard used by US, Canada, and Mexico. e.g. ATV,
                    Abrasive Product Manufacturing, Adhesive Manufacturing
                  type: array
                  items:
                    type: string
                sic_industry:
                  description: >-
                    SIC Industry. Standard Industrial Classification — 4-digit
                    codes used for business categorization. e.g. Accident/health
                    insurance carrier, Accounting/auditing/bookkeeping,
                    Adjustment/collection services
                  type: array
                  items:
                    type: string
                linkedin_industry:
                  description: >-
                    Industry. e.g. Accessible Architecture and Design,
                    Accommodation and Food Services, Accounting
                  type: array
                  items:
                    type: string
                crm:
                  description: CRM. e.g. Hubspot, Microsoft Dynamics, Pipedrive CRM
                  type: array
                  items:
                    type: string
                sales_automation:
                  description: Sales Automation. e.g. Apollo, Outreach, Salesloft
                  type: array
                  items:
                    type: string
                marketing_automation:
                  description: Marketing Automation. e.g. Hubspot, Klaviyo, Mailchimp
                  type: array
                  items:
                    type: string
                analytics:
                  description: Analytics. e.g. Looker, Power BI, Qlik
                  type: array
                  items:
                    type: string
                cms:
                  description: CMS. e.g. Adobe CQ, Adobe Experience Manager, Contentful
                  type: array
                  items:
                    type: string
                cloud_provider:
                  description: Cloud Provider. e.g. AWS, Alibaba, Google Cloud
                  type: array
                  items:
                    type: string
                development:
                  description: Development. e.g. Couchbase, MongoDB, Neo4j
                  type: array
                  items:
                    type: string
                ecommerce:
                  description: >-
                    E-Commerce. e.g. BigCommerce, Oracle Commerce, Salesforce
                    Commerce Cloud
                  type: array
                  items:
                    type: string
                erp:
                  description: ERP. e.g. acumatica, deltek erp, epicor eclipse
                  type: array
                  items:
                    type: string
                email_hosting:
                  description: Email Hosting. e.g. Google, Microsoft
                  type: array
                  items:
                    type: string
                email_security:
                  description: Email Security. e.g. Avanan, Barracuda, Egress
                  type: array
                  items:
                    type: string
                app_security:
                  description: App Security. e.g. Checkmarx, Semgrep, Snyk
                  type: array
                  items:
                    type: string
                cloud_security:
                  description: Cloud Security. e.g. Datadog, Lacework, Sysdig
                  type: array
                  items:
                    type: string
                abm:
                  description: ABM. e.g. 6Sense, Demandbase, Engagio
                  type: array
                  items:
                    type: string
                conversation_intelligence:
                  description: Conversation Intelligence. e.g. Aircall, Chorus, Clari
                  type: array
                  items:
                    type: string
                funding_type:
                  description: >-
                    Funding Type. e.g. Angel Round, Convertible Note, Corporate
                    Round
                  type: array
                  items:
                    type: string
                min_total_funding:
                  description: Min Total Funding
                  type: number
                  minimum: 0
                min_last_funding:
                  description: Min Last Funding
                  type: number
                  minimum: 0
                lead_investors:
                  description: Lead Investors. e.g. Sequoia Capital
                  type: string
                min_investors:
                  description: 'Min # Investors'
                  type: integer
                  minimum: 0
                min_total_traffic:
                  description: Total Traffic
                  type: number
                  minimum: 0
                min_organic_traffic:
                  description: Organic
                  type: number
                  minimum: 0
                min_paid_traffic:
                  description: Paid
                  type: number
                  minimum: 0
                min_ad_spend:
                  description: Ad Spend
                  type: number
                  minimum: 0
                min_linkedin_growth:
                  description: LI Growth %
                  type: number
                  minimum: 0
                min_engineering_headcount:
                  description: Engineering
                  type: number
                  minimum: 0
                min_sales_headcount:
                  description: Sales
                  type: number
                  minimum: 0
                min_marketing_headcount:
                  description: Marketing
                  type: number
                  minimum: 0
                min_sales_open_roles:
                  description: Sales
                  type: number
                  minimum: 0
                min_engineering_open_roles:
                  description: Engineering
                  type: number
                  minimum: 0
                min_marketing_open_roles:
                  description: Marketing
                  type: number
                  minimum: 0
                min_it_open_roles:
                  description: IT
                  type: number
                  minimum: 0
                min_devops_open_roles:
                  description: DevOps
                  type: number
                  minimum: 0
                has_mobile_app:
                  description: Has Mobile App. Company has a mobile application
                  type: boolean
                has_web_app:
                  description: Has Web App. Company has a web application
                  type: boolean
                has_ciso:
                  description: Has CISO. Company has a Chief Information Security Officer
                  type: boolean
                has_cio:
                  description: Has CIO. Company has a Chief Information Officer
                  type: boolean
                hq_country:
                  description: HQ Country. e.g. Afghanistan, Aland Islands, Albania
                  type: array
                  items:
                    type: string
                hq_city:
                  description: HQ City
                  type: array
                  items:
                    type: string
                hq_state:
                  description: HQ State. e.g. California
                  type: string
            example:
              include_title:
                - CTO
              country:
                - Germany
              page_size: 10
      responses:
        '200':
          description: Run completed.
          content:
            application/json:
              example:
                session_id: 11111111-1111-1111-1111-111111111111
                kind: leads_search
                company_linkedin_url: ''
                filters:
                  jobTitle:
                    - CTO
                  countryName:
                    - Germany
                exclude_filters: {}
                page: 1
                page_size: 10
                human: |-
                  # Leads search

                  - **Company:** any
                  - **Job title:** CTO
                  - **Country:** Germany
                  - **Page:** 1 (up to 10 per page)
                  - **Total matching:** 207929
                  - **Total pages:** 20793
                  - **Records returned:** 10
                machine:
                  page: 1
                  total_pages: 20793
                  total_results: 207929
                  has_more: true
                  total_items: 10
                  items:
                    - ranking: 1
                      full_name: Matthias Herbst
                      first_name: Matthias
                      last_name: Herbst
                      headline: Managing Director Marketing bei Herbst Holding GmbH
                      linkedin_url: https://www.linkedin.com/in/matthias-herbst-a6540183
                      location: Bielefeld, Germany
                      city: Bielefeld
                      state: null
                      country: Germany
                      email_domain: null
                      job_title: Managing Director Marketing
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills: []
                      company: null
                      company_linkedin_url: null
                      company_domain: null
                      company_employee_count: 0
                      company_industry: null
                      company_revenue: null
                      company_founded_on: '0'
                      company_hq: null
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 0
                      company_linkedin_growth_rate: 0
                    - ranking: 2
                      full_name: Jan Hering
                      first_name: Jan
                      last_name: Hering
                      headline: >-
                        Managing Director Marketing bei Markt-Apotheke Neustadt
                        in Holstein
                      linkedin_url: https://www.linkedin.com/in/jan-hering-00879299
                      location: Kiel, Germany
                      city: Kiel
                      state: null
                      country: Germany
                      email_domain: null
                      job_title: Managing Director Marketing
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills:
                        - projektmanagement
                        - product development
                        - strategische planung
                      company: null
                      company_linkedin_url: null
                      company_domain: null
                      company_employee_count: 0
                      company_industry: null
                      company_revenue: null
                      company_founded_on: '0'
                      company_hq: null
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 0
                      company_linkedin_growth_rate: 0
                    - ranking: 3
                      full_name: Schuetz Peter
                      first_name: Schuetz
                      last_name: Peter
                      headline: Managing Director Marketing bei Texon Components GmbH
                      linkedin_url: https://www.linkedin.com/in/schuetz-peter-b87727170
                      location: Saarbrücken, Germany
                      city: Saarbrücken
                      state: null
                      country: Germany
                      email_domain: null
                      job_title: Managing Director Marketing
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills: []
                      company: null
                      company_linkedin_url: null
                      company_domain: null
                      company_employee_count: 0
                      company_industry: null
                      company_revenue: null
                      company_founded_on: '0'
                      company_hq: null
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 0
                      company_linkedin_growth_rate: 0
                    - ranking: 4
                      full_name: Timo Kutschuk
                      first_name: Timo
                      last_name: Kutschuk
                      headline: >-
                        Geschäftsführer, Creative Director bei schwarzkupfer
                        designagentur
                      linkedin_url: https://www.linkedin.com/in/timo-kutschuk-57222b149
                      location: Erlenbach, Germany
                      city: Erlenbach
                      state: null
                      country: Germany
                      email_domain: null
                      job_title: Geschäftsführer, Creative Director
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills: []
                      company: null
                      company_linkedin_url: null
                      company_domain: null
                      company_employee_count: 0
                      company_industry: null
                      company_revenue: null
                      company_founded_on: '0'
                      company_hq: null
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 0
                      company_linkedin_growth_rate: 0
                    - ranking: 5
                      full_name: Andrea Gunschera
                      first_name: Andrea
                      last_name: Gunschera
                      headline: Without change, there's no butterflies
                      linkedin_url: https://www.linkedin.com/in/andrea-gunschera-b4a6846
                      location: Dresden, Germany
                      city: Dresden
                      state: null
                      country: Germany
                      email_domain: null
                      job_title: Founder, Executive Creative Director
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills:
                        - adobe photoshop
                        - interaction design
                        - photoshop
                      company: null
                      company_linkedin_url: null
                      company_domain: null
                      company_employee_count: 0
                      company_industry: null
                      company_revenue: null
                      company_founded_on: '0'
                      company_hq: null
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 0
                      company_linkedin_growth_rate: 0
                    - ranking: 6
                      full_name: Sven Sommerfeld
                      first_name: Sven
                      last_name: Sommerfeld
                      headline: >-
                        Geschäftsführer, Creative Director (Sven Sommerfeld –
                        Visual Communication Design)
                      linkedin_url: https://www.linkedin.com/in/sven-sommerfeld-160b8b224
                      location: Hamburg, Germany
                      city: Hamburg
                      state: null
                      country: Germany
                      email_domain: null
                      job_title: Geschäftsführer, Creative Director
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills: []
                      company: null
                      company_linkedin_url: null
                      company_domain: null
                      company_employee_count: 0
                      company_industry: null
                      company_revenue: null
                      company_founded_on: '0'
                      company_hq: null
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 0
                      company_linkedin_growth_rate: 0
                    - ranking: 7
                      full_name: Kilic Nihat
                      first_name: Kilic
                      last_name: Nihat
                      headline: Managing Director Marketing, bei nd. two media GmbH
                      linkedin_url: https://www.linkedin.com/in/kilic-nihat-68203b154
                      location: Haina, Germany
                      city: Haina
                      state: null
                      country: Germany
                      email_domain: null
                      job_title: Managing Director Marketing
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills: []
                      company: null
                      company_linkedin_url: null
                      company_domain: null
                      company_employee_count: 0
                      company_industry: null
                      company_revenue: null
                      company_founded_on: '0'
                      company_hq: null
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 0
                      company_linkedin_growth_rate: 0
                    - ranking: 8
                      full_name: Timm Paulick
                      first_name: Timm
                      last_name: Paulick
                      headline: >-
                        In Elternzeit, ehemals Executive Creative Director &
                        Head of Production bei 11+media GmbH
                      linkedin_url: https://www.linkedin.com/in/timm-paulick-67a15654
                      location: Hamburg, Germany
                      city: Hamburg
                      state: null
                      country: Germany
                      email_domain: 11plusmedia.com
                      job_title: Executive Creative Director & Head of Production
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills: []
                      company: 11 Media Gmbh
                      company_linkedin_url: https://www.linkedin.com/company/11plusmedia
                      company_domain: 11plusmedia.com
                      company_employee_count: 11
                      company_industry: null
                      company_revenue: null
                      company_founded_on: '2010'
                      company_hq: Eimsbüttel - Hamburg Eimsbüttel (stadtteil), Germany
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 1
                      company_linkedin_growth_rate: 100
                    - ranking: 9
                      full_name: Christian Rentschler
                      first_name: Christian
                      last_name: Rentschler
                      headline: executive creative director @ accenture song
                      linkedin_url: >-
                        https://www.linkedin.com/in/christian-rentschler-3a235618
                      location: hamburg, Germany
                      city: hamburg
                      state: null
                      country: Germany
                      email_domain: accenture.com
                      job_title: Executive Creative Director
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills:
                        - künstlerische leitung
                        - user experience
                        - fotografie
                      company: Accenture Song
                      company_linkedin_url: https://www.linkedin.com/company/accenture-song
                      company_domain: accenture.com
                      company_employee_count: 10110
                      company_industry: >-
                        Agents and Managers for Artists; Athletes; Entertainers;
                        and Other Public Figures;Employment Placement
                        Agencies;Graphic Design Services
                      company_revenue: $1B+
                      company_founded_on: '0'
                      company_hq: New York, United States
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 284480
                      company_linkedin_growth_rate: 1
                    - ranking: 10
                      full_name: Kevin Rupprecht
                      first_name: Kevin
                      last_name: Rupprecht
                      headline: ECD @ add2 digital communication
                      linkedin_url: https://www.linkedin.com/in/kevinrupprecht
                      location: Düsseldorf, Germany
                      city: Düsseldorf
                      state: null
                      country: Germany
                      email_domain: add2.de
                      job_title: Executive Creative Director
                      job_level: C-Level
                      job_function: Advertising & Marketing
                      skills:
                        - interaction design
                        - desktop publishing
                        - corporate identity
                      company: Add2 Gmbh
                      company_linkedin_url: https://www.linkedin.com/company/add2-gmbh
                      company_domain: add2.de
                      company_employee_count: 90
                      company_industry: >-
                        Marketing Consulting Services;Advertising
                        Agencies;Commercial Printing (Except Screen and Books)
                      company_revenue: null
                      company_founded_on: '1997'
                      company_hq: Düsseldorf, Germany
                      company_total_funding: 0
                      company_last_funding_type: null
                      company_last_funding_date: null
                      company_monthly_traffic: 0
                      company_linkedin_growth_rate: 1
                total_points: 20
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                    description: Session identifier for this run.
                  kind:
                    type: string
                    description: Data source identifier for this endpoint.
                  company_linkedin_url:
                    type: string
                  filters:
                    type: object
                    properties:
                      jobTitle:
                        type: array
                        items:
                          type: string
                      countryName:
                        type: array
                        items:
                          type: string
                  exclude_filters:
                    type: object
                    properties: {}
                  page:
                    type: integer
                  page_size:
                    type: integer
                  human:
                    type: string
                    description: Markdown summary of the result, for display.
                  machine:
                    type: object
                    properties:
                      page:
                        type: integer
                      total_pages:
                        type: integer
                      total_results:
                        type: integer
                      has_more:
                        type: boolean
                      total_items:
                        type: integer
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            ranking:
                              type: integer
                            full_name:
                              type: string
                            first_name:
                              type: string
                            last_name:
                              type: string
                            headline:
                              type: string
                            linkedin_url:
                              type: string
                            location:
                              type: string
                            city:
                              type: string
                            state: {}
                            country:
                              type: string
                            email_domain:
                              type: string
                              nullable: true
                            job_title:
                              type: string
                            job_level:
                              type: string
                            job_function:
                              type: string
                            skills:
                              type: array
                              items:
                                type: string
                                nullable: true
                            company:
                              type: string
                              nullable: true
                            company_linkedin_url:
                              type: string
                              nullable: true
                            company_domain:
                              type: string
                              nullable: true
                            company_employee_count:
                              type: integer
                            company_industry:
                              type: string
                              nullable: true
                            company_revenue:
                              type: string
                              nullable: true
                            company_founded_on:
                              type: string
                            company_hq:
                              type: string
                              nullable: true
                            company_total_funding:
                              type: integer
                            company_last_funding_type: {}
                            company_last_funding_date: {}
                            company_monthly_traffic:
                              type: integer
                            company_linkedin_growth_rate:
                              type: integer
                    description: Structured result payload.
                  total_points:
                    type: integer
                    description: Points charged for this run.
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '402':
          description: Payment Required
        '500':
          description: Internal Error
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.