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

> ## Agent Instructions
> BlitzAPI is the B2B Data API for GTM Builders: company and people search, enrichment, verified emails, US phone numbers and job postings behind one API key.
> Its data infrastructure holds 1B+ records: 550M+ professional profiles, 65M+ companies, 65M+ verified emails, 100M+ job postings and 45M+ US phone numbers.
> Pricing: Start $99, Scale $499, Build Your Infra from $999; every endpoint on every plan; fair use policy in records per month; rate limits per endpoint. Details: https://docs.blitz-api.ai/guide/concepts/pricing
> Company and product facts: https://www.blitz-api.ai/llms.txt

# TAM By People API: Companies by Buyer Persona

> Build a TAM from headcount signals: filter people by title, function, level and location plus firmographics, and get the distinct companies they work at.

> **Agents & LLMs**: a Markdown version of this page is available by appending `.md` to the URL, and the full documentation index is at [llms.txt](https://docs.blitz-api.ai/llms.txt).

TAM By People (`POST /v2/company/tam-by-people`) builds a total addressable market (TAM) from headcount signals. It takes the same filters as [Find People](https://docs.blitz-api.ai/api-reference/people-search/find-people.md), plus a `people.linkedin_url` filter and without the `include_active_jobs` and `include_past_jobs` flags (only current jobs count), but returns the **distinct companies** employing the matching people (deduplicated), each with its `matched_people` count. Use it to size the set of accounts that actually employ your buyer persona.

**1 record per result**

Combine people-level filters (title, job description, function, level, location, education) with company-level firmographics (industry, size, revenue, funding, HQ) in the same request.

> [!NOTE]
>
> **Pagination is cursor-based.** Pass the `cursor` returned by each response back into the next request. `cursor: null` means you're on the first page; a `null` cursor in the response means you've reached the end. Pagination stops at **50,000 companies**: the page that reaches this cap returns `cursor: null`, like a normal end. To go further, split the search into narrower filters that each stay under the cap.

> [!TIP]
>
> **`people.min_per_company`** floors the matched-people count, so only companies with at least that many matching employees are returned (max `25`, `0` = unset). When it filters heavily, a page may come back partial: keep paging until `cursor` is `null`.

> [!TIP]
>
> **TAM By People vs [TAM By Jobs](https://docs.blitz-api.ai/api-reference/company-search/tam-by-jobs.md):** By People sizes accounts on who already works there, By Jobs on who they are hiring. Use By People for persona-based ICP sizing, By Jobs for intent.

> [!TIP]
>
> **Filter logic:** all filters combine with **AND**. Multiple values within a single `include` list combine with **OR**. Use `exclude` to filter matches out.

> [card] [Company search guide](https://docs.blitz-api.ai/guide/concepts/company-search.md)
>
> Build an ICP-aligned company list, with a full walk-through and example filters.

> [card] [TAM By People API: product overview](https://www.blitz-api.ai/products/tam-by-people)
>
> Use cases, coverage, and the endpoints it chains with.


## OpenAPI

````yaml api-reference/v2.openapi.json POST /v2/company/tam-by-people
openapi: 3.1.0
info:
  title: BlitzAPI Reference
  version: 2.0.0
  description: >-
    Welcome to the BlitzAPI Reference.


    Use this interactive documentation to explore and test every v2 endpoint.
    Authentication is required via the `x-api-key` header.


    **Base URL**: `https://api.blitz-api.ai`


    **Rate limit**: Your requests-per-second limit depends on your plan and
    applies per endpoint: 5 requests per second on the free trial, 10 on Start,
    25 on Scale, custom on Build Your Infra. Each endpoint has its own
    independent budget, so different endpoints don't share the limit. It is
    counted per account: all API keys of your account share each endpoint's
    budget. Read your key's exact limit from `max_requests_per_seconds` on `GET
    /v2/account/key-info`.


    **Null fields**: In a request body, a field set to `null` is dropped before
    validation, at any depth, so it reads the same as leaving the field out and
    its default applies. A required field set to `null` still returns `422`, and
    so does a `null` item in a list.


    **Pricing**: Every plan opens every endpoint, within the plan's fair use
    policy (records per month). New accounts get 1,000 free records every month.
    Find Mobile & Direct Phone is not part of the trial. See [Plans &
    Pricing](/guide/concepts/pricing).
servers:
  - url: https://api.blitz-api.ai
    description: Production server
security: []
tags:
  - name: Account
    description: API key info and health check.
  - name: Waterfall ICP Search
    description: 'Priority-based cascade search: find the best-match contact at a company.'
  - name: Employee Finder
    description: Browse all employees at a single company with filters.
  - name: Company Search
    description: Search companies by industry, size, location, and keywords.
  - name: Job Search
    description: Search job postings by role, location, and company firmographics.
  - name: People Enrichment
    description: Enrich contacts with verified emails, phones, and reverse lookups.
  - name: Company Enrichment
    description: Enrich companies and resolve domain ↔ LinkedIn URL.
  - name: Utilities
    description: Helper endpoints (current date/time).
  - name: Changelog
    description: >-
      Public feed of API changes: breaking changes, features, fixes, and
      announcements.
paths:
  /v2/company/tam-by-people:
    post:
      tags:
        - Company Search
      summary: TAM By People
      description: >-
        Returns the distinct companies whose current employees match the people
        and firmographic filters (deduplicated), each with its matched-people
        count. Takes the same filters as [Find
        People](/api-reference/people-search/find-people), except
        `people.include_active_jobs` and `people.include_past_jobs`, which
        return 422 here since only current jobs count; `people.linkedin_url` and
        `people.min_per_company` are accepted here only. Optional
        people.min_per_company floors that count; when it filters heavily, a
        page may be partial, so keep paging until cursor is null. Cost: 1 record
        per result (max = max_results)
      operationId: postV2CompanyTamByPeople
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                company:
                  description: Company search criteria
                  type: object
                  properties:
                    linkedin_url:
                      description: >-
                        Exact matches for the LinkedIn URL of the company, to
                        look for people in the company
                      type: array
                      items:
                        type: string
                        examples:
                          - https://www.linkedin.com/company/blitz-api
                      maxItems: 50
                    name:
                      description: Keywords searched in the company name
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - []
                          description: >-
                            Keywords to keep. A record matches when it has all
                            the words of at least one keyword.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                        exclude:
                          default: []
                          examples:
                            - []
                          description: >-
                            Keywords to drop. A record is removed when it has
                            all the words of any one keyword.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                      additionalProperties: false
                    industry:
                      description: >-
                        Exact matches for the industry search. `Unknown` matches
                        a company with no industry on file, and a person with no
                        company: in `include` it is added to the listed
                        industries, in `exclude` it drops them.
                      type: object
                      properties:
                        include:
                          examples:
                            - - IT Services and IT Consulting
                          description: >-
                            Industries to keep, as exact LinkedIn labels.
                            `Unknown` also keeps a record with no industry on
                            file.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            enum:
                              - Abrasives and Nonmetallic Minerals Manufacturing
                              - Accessible Architecture and Design
                              - Accessible Hardware Manufacturing
                              - Accommodation and Food Services
                              - Accounting
                              - Administration of Justice
                              - Administrative and Support Services
                              - Advertising Services
                              - Agricultural Chemical Manufacturing
                              - >-
                                Agriculture; Construction; Mining Machinery
                                Manufacturing
                              - Airlines and Aviation
                              - Airlines/Aviation
                              - Air; Water; and Waste Program Management
                              - Alternative Dispute Resolution
                              - Alternative Fuel Vehicle Manufacturing
                              - Alternative Medicine
                              - Ambulance Services
                              - Amusement Parks and Arcades
                              - Animal Feed Manufacturing
                              - Animation
                              - Animation and Post-production
                              - Apparel and Fashion
                              - Apparel Manufacturing
                              - >-
                                Appliances; Electrical; and Electronics
                                Manufacturing
                              - Architectural and Structural Metal Manufacturing
                              - Architecture and Planning
                              - Armed Forces
                              - Artificial Intelligence
                              - >-
                                Artificial Rubber and Synthetic Fiber
                                Manufacturing
                              - Artists and Writers
                              - Arts and Crafts
                              - Audio and Video Equipment Manufacturing
                              - Automation Machinery Manufacturing
                              - Automotive
                              - Aviation and Aerospace
                              - Aviation and Aerospace Component Manufacturing
                              - Baked Goods Manufacturing
                              - Banking
                              - Bars; Taverns; and Nightclubs
                              - Bed-and-Breakfasts; Hostels; Homestays
                              - Beverage Manufacturing
                              - Biomass Electric Power Generation
                              - Biotechnology
                              - Biotechnology Research
                              - Blockchain Services
                              - Blogs
                              - >-
                                Boilers; Tanks; and Shipping Container
                                Manufacturing
                              - Book and Periodical Publishing
                              - Book Publishing
                              - Breweries
                              - Broadcast Media
                              - Broadcast Media Production and Distribution
                              - Building Construction
                              - Building Equipment Contractors
                              - Building Finishing Contractors
                              - Building Materials
                              - Building Structure and Exterior Contractors
                              - Business Consulting and Services
                              - Business Content
                              - Business Intelligence Platforms
                              - Business Supplies and Equipment
                              - Cable and Satellite Programming
                              - Capital Markets
                              - Caterers
                              - Chemical Manufacturing
                              - Chemical Raw Materials Manufacturing
                              - Chemicals
                              - Child Day Care Services
                              - Chiropractors
                              - Circuses and Magic Shows
                              - Civic and Social Organization
                              - Civic and Social Organizations
                              - Civil Engineering
                              - Claims Adjusting; Actuarial Services
                              - Clay and Refractory Products Manufacturing
                              - Climate Data and Analytics
                              - Climate Technology Product Manufacturing
                              - Coal Mining
                              - Collection Agencies
                              - Commercial and Industrial Equipment Rental
                              - Commercial and Industrial Machinery Maintenance
                              - >-
                                Commercial and Service Industry Machinery
                                Manufacturing
                              - Commercial Real Estate
                              - Communications Equipment Manufacturing
                              - Community Development and Urban Planning
                              - Community Services
                              - Computer and Network Security
                              - Computer Games
                              - Computer Hardware
                              - Computer Hardware Manufacturing
                              - Computer Networking
                              - Computer Networking Products
                              - Computers and Electronics Manufacturing
                              - Computer Software
                              - Conservation Programs
                              - Construction
                              - Construction Hardware Manufacturing
                              - Consumer Electronics
                              - Consumer Goods
                              - Consumer Goods Rental
                              - Consumer Services
                              - Correctional Institutions
                              - Cosmetics
                              - Cosmetology and Barber Schools
                              - Courts of Law
                              - Credit Intermediation
                              - Cutlery and Handtool Manufacturing
                              - Dairy
                              - Dairy Product Manufacturing
                              - Dance Companies
                              - Data Infrastructure and Analytics
                              - Data Security Software Products
                              - Death Care Services
                              - Defense and Space
                              - Defense and Space Manufacturing
                              - Dentists
                              - Design
                              - Design Services
                              - Desktop Computing Software Products
                              - Digital Accessibility Services
                              - Distilleries
                              - Economic Programs
                              - Education
                              - Education Administration Programs
                              - Education Management
                              - E-learning
                              - E-Learning Providers
                              - Electrical and Electronic Manufacturing
                              - Electrical Equipment Manufacturing
                              - Electric Lighting Equipment Manufacturing
                              - Electric Power Generation
                              - >-
                                Electric Power Transmission; Control; and
                                Distribution
                              - Electronic and Precision Equipment Maintenance
                              - Embedded Software Products
                              - Emergency and Relief Services
                              - Energy Technology
                              - Engineering Services
                              - >-
                                Engines and Power Transmission Equipment
                                Manufacturing
                              - Entertainment
                              - Entertainment Providers
                              - Environmental Quality Programs
                              - Environmental Services
                              - Equipment Rental Services
                              - Events Services
                              - Executive Office
                              - Executive Offices
                              - Executive Search Services
                              - Fabricated Metal Products
                              - Facilities Services
                              - Family Planning Centers
                              - Farming
                              - Farming; Ranching; Forestry
                              - Fashion Accessories Manufacturing
                              - Financial Services
                              - Fine Art
                              - Fine Arts Schools
                              - Fire Protection
                              - Fisheries
                              - Fishery
                              - Flight Training
                              - Food and Beverage Manufacturing
                              - Food and Beverage Retail
                              - Food and Beverages
                              - Food and Beverage Services
                              - Food Production
                              - Footwear and Leather Goods Repair
                              - Footwear Manufacturing
                              - Forestry and Logging
                              - Fossil Fuel Electric Power Generation
                              - Freight and Package Transportation
                              - Fruit and Vegetable Preserves Manufacturing
                              - Fuel Cell Manufacturing
                              - Fundraising
                              - Funds and Trusts
                              - Funeral Services
                              - Furniture
                              - Furniture and Home Furnishings Manufacturing
                              - Gambling and Casinos
                              - Gambling Facilities and Casinos
                              - Geothermal Electric Power Generation
                              - Glass; Ceramics and Concrete
                              - Glass; Ceramics and Concrete Manufacturing
                              - Glass Product Manufacturing
                              - Golf Courses and Country Clubs
                              - Government Administration
                              - Government Relations
                              - Government Relations Services
                              - Graphic Design
                              - Ground Passenger Transportation
                              - Health and Human Services
                              - Health; Wellness and Fitness
                              - Higher Education
                              - Highway; Street; and Bridge Construction
                              - Historical Sites
                              - Holding Companies
                              - Home Health Care Services
                              - Horticulture
                              - Hospital and Health Care
                              - Hospitality
                              - Hospitals
                              - Hospitals and Health Care
                              - Hotels and Motels
                              - >-
                                Household and Institutional Furniture
                                Manufacturing
                              - Household Appliance Manufacturing
                              - Household Services
                              - Housing and Community Development
                              - Housing Programs
                              - Human Resources
                              - Human Resources Services
                              - HVAC and Refrigeration Equipment Manufacturing
                              - Hydroelectric Power Generation
                              - Import and Export
                              - Individual and Family Services
                              - Industrial Automation
                              - Industrial Machinery Manufacturing
                              - Industry Associations
                              - Information Services
                              - Information Technology and Services
                              - Insurance
                              - Insurance Agencies and Brokerages
                              - Insurance and Employee Benefit Funds
                              - Insurance Carriers
                              - Interior Design
                              - International Affairs
                              - International Trade and Development
                              - Internet
                              - Internet Marketplace Platforms
                              - Internet News
                              - Internet Publishing
                              - Interurban and Rural Bus Services
                              - Investment Advice
                              - Investment Banking
                              - Investment Management
                              - IT Services and IT Consulting
                              - IT System Custom Software Development
                              - IT System Data Services
                              - IT System Design Services
                              - IT System Installation and Disposal
                              - IT System Operations and Maintenance
                              - IT System Testing and Evaluation
                              - IT System Training and Support
                              - Janitorial Services
                              - Judiciary
                              - Landscaping Services
                              - Language Schools
                              - Laundry and Drycleaning Services
                              - Law Enforcement
                              - Law Practice
                              - Leasing Non-residential Real Estate
                              - Leasing Residential Real Estate
                              - Leather Product Manufacturing
                              - Legal Services
                              - Legislative Offices
                              - Leisure; Travel and Tourism
                              - Libraries
                              - Lime and Gypsum Products Manufacturing
                              - Loan Brokers
                              - Logistics and Supply Chain
                              - Luxury Goods and Jewelry
                              - Machinery
                              - Machinery Manufacturing
                              - Magnetic and Optical Media Manufacturing
                              - Management Consulting
                              - Manufacturing
                              - Maritime
                              - Maritime Transportation
                              - Marketing and Advertising
                              - Marketing Services
                              - Market Research
                              - Mattress and Blinds Manufacturing
                              - Measuring and Control Instrument Manufacturing
                              - Meat Products Manufacturing
                              - Mechanical Or Industrial Engineering
                              - Media and Telecommunications
                              - Media Production
                              - Medical and Diagnostic Laboratories
                              - Medical Device
                              - Medical Equipment Manufacturing
                              - Medical Practice
                              - Medical Practices
                              - Mental Health Care
                              - Metal Ore Mining
                              - Metal Treatments
                              - Metal Valve; Ball; and Roller Manufacturing
                              - Metalworking Machinery Manufacturing
                              - Military
                              - Military and International Affairs
                              - Mining
                              - Mining and Metals
                              - Mobile Computing Software Products
                              - Mobile Food Services
                              - Mobile Games
                              - Mobile Gaming Apps
                              - Motion Pictures and Film
                              - Motor Vehicle Manufacturing
                              - Motor Vehicle Parts Manufacturing
                              - Movies and Sound Recording
                              - Movies; Videos; and Sound
                              - Museums
                              - Museums and Institutions
                              - Museums; Historical Sites; and Zoos
                              - Music
                              - Musicians
                              - Nanotechnology
                              - Nanotechnology Research
                              - Natural Gas Distribution
                              - Natural Gas Extraction
                              - Newspaper Publishing
                              - Newspapers
                              - Nonmetallic Mineral Mining
                              - Non-profit Organization Management
                              - Non-profit Organizations
                              - Nonresidential Building Construction
                              - Nuclear Electric Power Generation
                              - Nursing Homes and Residential Care Facilities
                              - Office Administration
                              - Office Furniture and Fixtures Manufacturing
                              - Oil and Coal Product Manufacturing
                              - Oil and Energy
                              - Oil and Gas
                              - Oil Extraction
                              - Oil; Gas; and Mining
                              - Online and Mail Order Retail
                              - Online Audio and Video Media
                              - Online Media
                              - Operations Consulting
                              - Optometrists
                              - Other
                              - Outpatient Care Centers
                              - Outsourcing and Offshoring Consulting
                              - Outsourcing/Offshoring
                              - Package/Freight Delivery
                              - Packaging and Containers
                              - Packaging and Containers Manufacturing
                              - Paint; Coating; and Adhesive Manufacturing
                              - Paper and Forest Product Manufacturing
                              - Paper and Forest Products
                              - Parts Distribution
                              - Pension Funds
                              - Performing Arts
                              - Performing Arts and Spectator Sports
                              - Periodical Publishing
                              - Personal and Laundry Services
                              - Personal Care Product Manufacturing
                              - Personal Care Services
                              - Pet Services
                              - Pharmaceutical Manufacturing
                              - Pharmaceuticals
                              - Philanthropic Fundraising Services
                              - Philanthropy
                              - Photography
                              - Physical; Occupational and Speech Therapists
                              - Physicians
                              - Pipeline Transportation
                              - Plastics
                              - Plastics and Rubber Product Manufacturing
                              - Plastics Manufacturing
                              - Political Organization
                              - Political Organizations
                              - Postal Services
                              - Primary and Secondary Education
                              - Primary Metal Manufacturing
                              - Primary/Secondary Education
                              - Printing
                              - Printing Services
                              - Professional Organizations
                              - Professional Services
                              - Professional Training and Coaching
                              - Program Development
                              - Public Assistance Programs
                              - Public Health
                              - Public Policy
                              - Public Policy Offices
                              - Public Relations and Communications
                              - Public Relations and Communications Services
                              - Public Safety
                              - Public Works
                              - Publishing
                              - Racetracks
                              - Radio and Television Broadcasting
                              - Railroad Equipment Manufacturing
                              - Railroad Manufacture
                              - Rail Transportation
                              - Ranching
                              - Ranching and Fisheries
                              - Real Estate
                              - Real Estate Agents and Brokers
                              - Real Estate and Equipment Rental Services
                              - Recreational Facilities
                              - Recreational Facilities and Services
                              - Regenerative Design
                              - Religious Institutions
                              - Renewable Energy Equipment Manufacturing
                              - Renewable Energy Power Generation
                              - Renewable Energy Semiconductor Manufacturing
                              - Renewables and Environment
                              - Repair and Maintenance
                              - Research
                              - Research Services
                              - Residential Building Construction
                              - Restaurants
                              - Retail
                              - Retail Apparel and Fashion
                              - >-
                                Retail Appliances; Electrical; and Electronic
                                Equipment
                              - Retail Art Dealers
                              - Retail Art Supplies
                              - Retail Books and Printed News
                              - Retail Building Materials and Garden Equipment
                              - Retail Florists
                              - Retail Furniture and Home Furnishings
                              - Retail Gasoline
                              - Retail Groceries
                              - Retail Health and Personal Care Products
                              - Retail Luxury Goods and Jewelry
                              - Retail Motor Vehicles
                              - Retail Musical Instruments
                              - Retail Office Equipment
                              - Retail Office Supplies and Gifts
                              - Retail Pharmacies
                              - Retail Recyclable Materials and Used Merchandise
                              - Reupholstery and Furniture Repair
                              - Robotics Engineering
                              - Robot Manufacturing
                              - Rubber Products Manufacturing
                              - Satellite Telecommunications
                              - Savings Institutions
                              - School and Employee Bus Services
                              - Seafood Product Manufacturing
                              - Secretarial Schools
                              - Securities and Commodity Exchanges
                              - Security and Investigations
                              - Security Guards and Patrol Services
                              - Security Systems Services
                              - Semiconductor Manufacturing
                              - Semiconductors
                              - Services for Renewable Energy
                              - Services for the Elderly and Disabled
                              - Sheet Music Publishing
                              - Shipbuilding
                              - >-
                                Shuttles and Special Needs Transportation
                                Services
                              - Sightseeing Transportation
                              - Skiing Facilities
                              - Smart Meter Manufacturing
                              - Soap and Cleaning Product Manufacturing
                              - Social Networking Platforms
                              - Software Development
                              - Solar Electric Power Generation
                              - Sound Recording
                              - Space Research and Technology
                              - Specialty Trade Contractors
                              - Spectator Sports
                              - Sporting Goods
                              - Sporting Goods Manufacturing
                              - Sports
                              - Sports and Recreation Instruction
                              - Sports Teams and Clubs
                              - Spring and Wire Product Manufacturing
                              - Staffing and Recruiting
                              - Steam and Air-Conditioning Supply
                              - Strategic Management Services
                              - Subdivision of Land
                              - Sugar and Confectionery Product Manufacturing
                              - Supermarkets
                              - Surveying and Mapping Services
                              - Taxi and Limousine Services
                              - Technical and Vocational Training
                              - Technology; Information and Internet
                              - Technology; Information and Media
                              - Telecommunications
                              - Telecommunications Carriers
                              - Telephone Call Centers
                              - Temporary Help Services
                              - Textile Manufacturing
                              - Textiles
                              - Theater Companies
                              - Think Tanks
                              - Tobacco
                              - Tobacco Manufacturing
                              - Translation and Localization
                              - Transportation Equipment Manufacturing
                              - >-
                                Transportation; Logistics; Supply Chain and
                                Storage
                              - Transportation Programs
                              - Transportation/Trucking/Railroad
                              - Travel Arrangements
                              - Truck Transportation
                              - Trusts and Estates
                              - Turned Products and Fastener Manufacturing
                              - Urban Transit Services
                              - Utilities
                              - Utilities Administration
                              - Utility System Construction
                              - Vehicle Repair and Maintenance
                              - Venture Capital and Private Equity
                              - Venture Capital and Private Equity Principals
                              - Veterinary
                              - Veterinary Services
                              - Vocational Rehabilitation Services
                              - Warehousing
                              - Warehousing and Storage
                              - Waste Collection
                              - Waste Treatment and Disposal
                              - Water Supply and Irrigation Systems
                              - >-
                                Water; Waste; Steam; and Air Conditioning
                                Services
                              - Wellness and Fitness Services
                              - Wholesale
                              - Wholesale Alcoholic Beverages
                              - Wholesale Apparel and Sewing Supplies
                              - >-
                                Wholesale Appliances; Electrical; and
                                Electronics
                              - Wholesale Building Materials
                              - Wholesale Chemical and Allied Products
                              - Wholesale Computer Equipment
                              - Wholesale Drugs and Sundries
                              - Wholesale Food and Beverage
                              - Wholesale Footwear
                              - Wholesale Furniture and Home Furnishings
                              - Wholesale Hardware; Plumbing; Heating Equipment
                              - Wholesale Import and Export
                              - Wholesale Luxury Goods and Jewelry
                              - Wholesale Machinery
                              - Wholesale Metals and Minerals
                              - Wholesale Motor Vehicles and Parts
                              - Wholesale Paper Products
                              - Wholesale Petroleum and Petroleum Products
                              - Wholesale Photography Equipment and Supplies
                              - Wholesale Raw Farm Products
                              - Wholesale Recyclable Materials
                              - Wind Electric Power Generation
                              - Wine and Spirits
                              - Wineries
                              - Wireless
                              - Wireless Services
                              - Women\\'s Handbag Manufacturing
                              - Wood Product Manufacturing
                              - Writing and Editing
                              - Zoos and Botanical Gardens
                              - Unknown
                        exclude:
                          examples:
                            - []
                          description: >-
                            Industries to drop, as exact LinkedIn labels.
                            `Unknown` drops a record with no industry on file.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            enum:
                              - Abrasives and Nonmetallic Minerals Manufacturing
                              - Accessible Architecture and Design
                              - Accessible Hardware Manufacturing
                              - Accommodation and Food Services
                              - Accounting
                              - Administration of Justice
                              - Administrative and Support Services
                              - Advertising Services
                              - Agricultural Chemical Manufacturing
                              - >-
                                Agriculture; Construction; Mining Machinery
                                Manufacturing
                              - Airlines and Aviation
                              - Airlines/Aviation
                              - Air; Water; and Waste Program Management
                              - Alternative Dispute Resolution
                              - Alternative Fuel Vehicle Manufacturing
                              - Alternative Medicine
                              - Ambulance Services
                              - Amusement Parks and Arcades
                              - Animal Feed Manufacturing
                              - Animation
                              - Animation and Post-production
                              - Apparel and Fashion
                              - Apparel Manufacturing
                              - >-
                                Appliances; Electrical; and Electronics
                                Manufacturing
                              - Architectural and Structural Metal Manufacturing
                              - Architecture and Planning
                              - Armed Forces
                              - Artificial Intelligence
                              - >-
                                Artificial Rubber and Synthetic Fiber
                                Manufacturing
                              - Artists and Writers
                              - Arts and Crafts
                              - Audio and Video Equipment Manufacturing
                              - Automation Machinery Manufacturing
                              - Automotive
                              - Aviation and Aerospace
                              - Aviation and Aerospace Component Manufacturing
                              - Baked Goods Manufacturing
                              - Banking
                              - Bars; Taverns; and Nightclubs
                              - Bed-and-Breakfasts; Hostels; Homestays
                              - Beverage Manufacturing
                              - Biomass Electric Power Generation
                              - Biotechnology
                              - Biotechnology Research
                              - Blockchain Services
                              - Blogs
                              - >-
                                Boilers; Tanks; and Shipping Container
                                Manufacturing
                              - Book and Periodical Publishing
                              - Book Publishing
                              - Breweries
                              - Broadcast Media
                              - Broadcast Media Production and Distribution
                              - Building Construction
                              - Building Equipment Contractors
                              - Building Finishing Contractors
                              - Building Materials
                              - Building Structure and Exterior Contractors
                              - Business Consulting and Services
                              - Business Content
                              - Business Intelligence Platforms
                              - Business Supplies and Equipment
                              - Cable and Satellite Programming
                              - Capital Markets
                              - Caterers
                              - Chemical Manufacturing
                              - Chemical Raw Materials Manufacturing
                              - Chemicals
                              - Child Day Care Services
                              - Chiropractors
                              - Circuses and Magic Shows
                              - Civic and Social Organization
                              - Civic and Social Organizations
                              - Civil Engineering
                              - Claims Adjusting; Actuarial Services
                              - Clay and Refractory Products Manufacturing
                              - Climate Data and Analytics
                              - Climate Technology Product Manufacturing
                              - Coal Mining
                              - Collection Agencies
                              - Commercial and Industrial Equipment Rental
                              - Commercial and Industrial Machinery Maintenance
                              - >-
                                Commercial and Service Industry Machinery
                                Manufacturing
                              - Commercial Real Estate
                              - Communications Equipment Manufacturing
                              - Community Development and Urban Planning
                              - Community Services
                              - Computer and Network Security
                              - Computer Games
                              - Computer Hardware
                              - Computer Hardware Manufacturing
                              - Computer Networking
                              - Computer Networking Products
                              - Computers and Electronics Manufacturing
                              - Computer Software
                              - Conservation Programs
                              - Construction
                              - Construction Hardware Manufacturing
                              - Consumer Electronics
                              - Consumer Goods
                              - Consumer Goods Rental
                              - Consumer Services
                              - Correctional Institutions
                              - Cosmetics
                              - Cosmetology and Barber Schools
                              - Courts of Law
                              - Credit Intermediation
                              - Cutlery and Handtool Manufacturing
                              - Dairy
                              - Dairy Product Manufacturing
                              - Dance Companies
                              - Data Infrastructure and Analytics
                              - Data Security Software Products
                              - Death Care Services
                              - Defense and Space
                              - Defense and Space Manufacturing
                              - Dentists
                              - Design
                              - Design Services
                              - Desktop Computing Software Products
                              - Digital Accessibility Services
                              - Distilleries
                              - Economic Programs
                              - Education
                              - Education Administration Programs
                              - Education Management
                              - E-learning
                              - E-Learning Providers
                              - Electrical and Electronic Manufacturing
                              - Electrical Equipment Manufacturing
                              - Electric Lighting Equipment Manufacturing
                              - Electric Power Generation
                              - >-
                                Electric Power Transmission; Control; and
                                Distribution
                              - Electronic and Precision Equipment Maintenance
                              - Embedded Software Products
                              - Emergency and Relief Services
                              - Energy Technology
                              - Engineering Services
                              - >-
                                Engines and Power Transmission Equipment
                                Manufacturing
                              - Entertainment
                              - Entertainment Providers
                              - Environmental Quality Programs
                              - Environmental Services
                              - Equipment Rental Services
                              - Events Services
                              - Executive Office
                              - Executive Offices
                              - Executive Search Services
                              - Fabricated Metal Products
                              - Facilities Services
                              - Family Planning Centers
                              - Farming
                              - Farming; Ranching; Forestry
                              - Fashion Accessories Manufacturing
                              - Financial Services
                              - Fine Art
                              - Fine Arts Schools
                              - Fire Protection
                              - Fisheries
                              - Fishery
                              - Flight Training
                              - Food and Beverage Manufacturing
                              - Food and Beverage Retail
                              - Food and Beverages
                              - Food and Beverage Services
                              - Food Production
                              - Footwear and Leather Goods Repair
                              - Footwear Manufacturing
                              - Forestry and Logging
                              - Fossil Fuel Electric Power Generation
                              - Freight and Package Transportation
                              - Fruit and Vegetable Preserves Manufacturing
                              - Fuel Cell Manufacturing
                              - Fundraising
                              - Funds and Trusts
                              - Funeral Services
                              - Furniture
                              - Furniture and Home Furnishings Manufacturing
                              - Gambling and Casinos
                              - Gambling Facilities and Casinos
                              - Geothermal Electric Power Generation
                              - Glass; Ceramics and Concrete
                              - Glass; Ceramics and Concrete Manufacturing
                              - Glass Product Manufacturing
                              - Golf Courses and Country Clubs
                              - Government Administration
                              - Government Relations
                              - Government Relations Services
                              - Graphic Design
                              - Ground Passenger Transportation
                              - Health and Human Services
                              - Health; Wellness and Fitness
                              - Higher Education
                              - Highway; Street; and Bridge Construction
                              - Historical Sites
                              - Holding Companies
                              - Home Health Care Services
                              - Horticulture
                              - Hospital and Health Care
                              - Hospitality
                              - Hospitals
                              - Hospitals and Health Care
                              - Hotels and Motels
                              - >-
                                Household and Institutional Furniture
                                Manufacturing
                              - Household Appliance Manufacturing
                              - Household Services
                              - Housing and Community Development
                              - Housing Programs
                              - Human Resources
                              - Human Resources Services
                              - HVAC and Refrigeration Equipment Manufacturing
                              - Hydroelectric Power Generation
                              - Import and Export
                              - Individual and Family Services
                              - Industrial Automation
                              - Industrial Machinery Manufacturing
                              - Industry Associations
                              - Information Services
                              - Information Technology and Services
                              - Insurance
                              - Insurance Agencies and Brokerages
                              - Insurance and Employee Benefit Funds
                              - Insurance Carriers
                              - Interior Design
                              - International Affairs
                              - International Trade and Development
                              - Internet
                              - Internet Marketplace Platforms
                              - Internet News
                              - Internet Publishing
                              - Interurban and Rural Bus Services
                              - Investment Advice
                              - Investment Banking
                              - Investment Management
                              - IT Services and IT Consulting
                              - IT System Custom Software Development
                              - IT System Data Services
                              - IT System Design Services
                              - IT System Installation and Disposal
                              - IT System Operations and Maintenance
                              - IT System Testing and Evaluation
                              - IT System Training and Support
                              - Janitorial Services
                              - Judiciary
                              - Landscaping Services
                              - Language Schools
                              - Laundry and Drycleaning Services
                              - Law Enforcement
                              - Law Practice
                              - Leasing Non-residential Real Estate
                              - Leasing Residential Real Estate
                              - Leather Product Manufacturing
                              - Legal Services
                              - Legislative Offices
                              - Leisure; Travel and Tourism
                              - Libraries
                              - Lime and Gypsum Products Manufacturing
                              - Loan Brokers
                              - Logistics and Supply Chain
                              - Luxury Goods and Jewelry
                              - Machinery
                              - Machinery Manufacturing
                              - Magnetic and Optical Media Manufacturing
                              - Management Consulting
                              - Manufacturing
                              - Maritime
                              - Maritime Transportation
                              - Marketing and Advertising
                              - Marketing Services
                              - Market Research
                              - Mattress and Blinds Manufacturing
                              - Measuring and Control Instrument Manufacturing
                              - Meat Products Manufacturing
                              - Mechanical Or Industrial Engineering
                              - Media and Telecommunications
                              - Media Production
                              - Medical and Diagnostic Laboratories
                              - Medical Device
                              - Medical Equipment Manufacturing
                              - Medical Practice
                              - Medical Practices
                              - Mental Health Care
                              - Metal Ore Mining
                              - Metal Treatments
                              - Metal Valve; Ball; and Roller Manufacturing
                              - Metalworking Machinery Manufacturing
                              - Military
                              - Military and International Affairs
                              - Mining
                              - Mining and Metals
                              - Mobile Computing Software Products
                              - Mobile Food Services
                              - Mobile Games
                              - Mobile Gaming Apps
                              - Motion Pictures and Film
                              - Motor Vehicle Manufacturing
                              - Motor Vehicle Parts Manufacturing
                              - Movies and Sound Recording
                              - Movies; Videos; and Sound
                              - Museums
                              - Museums and Institutions
                              - Museums; Historical Sites; and Zoos
                              - Music
                              - Musicians
                              - Nanotechnology
                              - Nanotechnology Research
                              - Natural Gas Distribution
                              - Natural Gas Extraction
                              - Newspaper Publishing
                              - Newspapers
                              - Nonmetallic Mineral Mining
                              - Non-profit Organization Management
                              - Non-profit Organizations
                              - Nonresidential Building Construction
                              - Nuclear Electric Power Generation
                              - Nursing Homes and Residential Care Facilities
                              - Office Administration
                              - Office Furniture and Fixtures Manufacturing
                              - Oil and Coal Product Manufacturing
                              - Oil and Energy
                              - Oil and Gas
                              - Oil Extraction
                              - Oil; Gas; and Mining
                              - Online and Mail Order Retail
                              - Online Audio and Video Media
                              - Online Media
                              - Operations Consulting
                              - Optometrists
                              - Other
                              - Outpatient Care Centers
                              - Outsourcing and Offshoring Consulting
                              - Outsourcing/Offshoring
                              - Package/Freight Delivery
                              - Packaging and Containers
                              - Packaging and Containers Manufacturing
                              - Paint; Coating; and Adhesive Manufacturing
                              - Paper and Forest Product Manufacturing
                              - Paper and Forest Products
                              - Parts Distribution
                              - Pension Funds
                              - Performing Arts
                              - Performing Arts and Spectator Sports
                              - Periodical Publishing
                              - Personal and Laundry Services
                              - Personal Care Product Manufacturing
                              - Personal Care Services
                              - Pet Services
                              - Pharmaceutical Manufacturing
                              - Pharmaceuticals
                              - Philanthropic Fundraising Services
                              - Philanthropy
                              - Photography
                              - Physical; Occupational and Speech Therapists
                              - Physicians
                              - Pipeline Transportation
                              - Plastics
                              - Plastics and Rubber Product Manufacturing
                              - Plastics Manufacturing
                              - Political Organization
                              - Political Organizations
                              - Postal Services
                              - Primary and Secondary Education
                              - Primary Metal Manufacturing
                              - Primary/Secondary Education
                              - Printing
                              - Printing Services
                              - Professional Organizations
                              - Professional Services
                              - Professional Training and Coaching
                              - Program Development
                              - Public Assistance Programs
                              - Public Health
                              - Public Policy
                              - Public Policy Offices
                              - Public Relations and Communications
                              - Public Relations and Communications Services
                              - Public Safety
                              - Public Works
                              - Publishing
                              - Racetracks
                              - Radio and Television Broadcasting
                              - Railroad Equipment Manufacturing
                              - Railroad Manufacture
                              - Rail Transportation
                              - Ranching
                              - Ranching and Fisheries
                              - Real Estate
                              - Real Estate Agents and Brokers
                              - Real Estate and Equipment Rental Services
                              - Recreational Facilities
                              - Recreational Facilities and Services
                              - Regenerative Design
                              - Religious Institutions
                              - Renewable Energy Equipment Manufacturing
                              - Renewable Energy Power Generation
                              - Renewable Energy Semiconductor Manufacturing
                              - Renewables and Environment
                              - Repair and Maintenance
                              - Research
                              - Research Services
                              - Residential Building Construction
                              - Restaurants
                              - Retail
                              - Retail Apparel and Fashion
                              - >-
                                Retail Appliances; Electrical; and Electronic
                                Equipment
                              - Retail Art Dealers
                              - Retail Art Supplies
                              - Retail Books and Printed News
                              - Retail Building Materials and Garden Equipment
                              - Retail Florists
                              - Retail Furniture and Home Furnishings
                              - Retail Gasoline
                              - Retail Groceries
                              - Retail Health and Personal Care Products
                              - Retail Luxury Goods and Jewelry
                              - Retail Motor Vehicles
                              - Retail Musical Instruments
                              - Retail Office Equipment
                              - Retail Office Supplies and Gifts
                              - Retail Pharmacies
                              - Retail Recyclable Materials and Used Merchandise
                              - Reupholstery and Furniture Repair
                              - Robotics Engineering
                              - Robot Manufacturing
                              - Rubber Products Manufacturing
                              - Satellite Telecommunications
                              - Savings Institutions
                              - School and Employee Bus Services
                              - Seafood Product Manufacturing
                              - Secretarial Schools
                              - Securities and Commodity Exchanges
                              - Security and Investigations
                              - Security Guards and Patrol Services
                              - Security Systems Services
                              - Semiconductor Manufacturing
                              - Semiconductors
                              - Services for Renewable Energy
                              - Services for the Elderly and Disabled
                              - Sheet Music Publishing
                              - Shipbuilding
                              - >-
                                Shuttles and Special Needs Transportation
                                Services
                              - Sightseeing Transportation
                              - Skiing Facilities
                              - Smart Meter Manufacturing
                              - Soap and Cleaning Product Manufacturing
                              - Social Networking Platforms
                              - Software Development
                              - Solar Electric Power Generation
                              - Sound Recording
                              - Space Research and Technology
                              - Specialty Trade Contractors
                              - Spectator Sports
                              - Sporting Goods
                              - Sporting Goods Manufacturing
                              - Sports
                              - Sports and Recreation Instruction
                              - Sports Teams and Clubs
                              - Spring and Wire Product Manufacturing
                              - Staffing and Recruiting
                              - Steam and Air-Conditioning Supply
                              - Strategic Management Services
                              - Subdivision of Land
                              - Sugar and Confectionery Product Manufacturing
                              - Supermarkets
                              - Surveying and Mapping Services
                              - Taxi and Limousine Services
                              - Technical and Vocational Training
                              - Technology; Information and Internet
                              - Technology; Information and Media
                              - Telecommunications
                              - Telecommunications Carriers
                              - Telephone Call Centers
                              - Temporary Help Services
                              - Textile Manufacturing
                              - Textiles
                              - Theater Companies
                              - Think Tanks
                              - Tobacco
                              - Tobacco Manufacturing
                              - Translation and Localization
                              - Transportation Equipment Manufacturing
                              - >-
                                Transportation; Logistics; Supply Chain and
                                Storage
                              - Transportation Programs
                              - Transportation/Trucking/Railroad
                              - Travel Arrangements
                              - Truck Transportation
                              - Trusts and Estates
                              - Turned Products and Fastener Manufacturing
                              - Urban Transit Services
                              - Utilities
                              - Utilities Administration
                              - Utility System Construction
                              - Vehicle Repair and Maintenance
                              - Venture Capital and Private Equity
                              - Venture Capital and Private Equity Principals
                              - Veterinary
                              - Veterinary Services
                              - Vocational Rehabilitation Services
                              - Warehousing
                              - Warehousing and Storage
                              - Waste Collection
                              - Waste Treatment and Disposal
                              - Water Supply and Irrigation Systems
                              - >-
                                Water; Waste; Steam; and Air Conditioning
                                Services
                              - Wellness and Fitness Services
                              - Wholesale
                              - Wholesale Alcoholic Beverages
                              - Wholesale Apparel and Sewing Supplies
                              - >-
                                Wholesale Appliances; Electrical; and
                                Electronics
                              - Wholesale Building Materials
                              - Wholesale Chemical and Allied Products
                              - Wholesale Computer Equipment
                              - Wholesale Drugs and Sundries
                              - Wholesale Food and Beverage
                              - Wholesale Footwear
                              - Wholesale Furniture and Home Furnishings
                              - Wholesale Hardware; Plumbing; Heating Equipment
                              - Wholesale Import and Export
                              - Wholesale Luxury Goods and Jewelry
                              - Wholesale Machinery
                              - Wholesale Metals and Minerals
                              - Wholesale Motor Vehicles and Parts
                              - Wholesale Paper Products
                              - Wholesale Petroleum and Petroleum Products
                              - Wholesale Photography Equipment and Supplies
                              - Wholesale Raw Farm Products
                              - Wholesale Recyclable Materials
                              - Wind Electric Power Generation
                              - Wine and Spirits
                              - Wineries
                              - Wireless
                              - Wireless Services
                              - Women\\'s Handbag Manufacturing
                              - Wood Product Manufacturing
                              - Writing and Editing
                              - Zoos and Botanical Gardens
                              - Unknown
                      additionalProperties: false
                    type:
                      description: Exact matches for the company type search
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - []
                          description: >-
                            Company types to keep. A company matches when its
                            type is any listed value.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            enum:
                              - Educational
                              - Educational Institution
                              - Government Agency
                              - Nonprofit
                              - Partnership
                              - Privately Held
                              - Public Company
                              - Self-Employed
                              - Self-Owned
                              - Sole Proprietorship
                        exclude:
                          default: []
                          examples:
                            - - Nonprofit
                              - Partnership
                          description: >-
                            Company types to drop. A company is removed when its
                            type is any listed value.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            enum:
                              - Educational
                              - Educational Institution
                              - Government Agency
                              - Nonprofit
                              - Partnership
                              - Privately Held
                              - Public Company
                              - Self-Employed
                              - Self-Owned
                              - Sole Proprietorship
                      additionalProperties: false
                    employee_range:
                      default: []
                      examples:
                        - - 1-10
                          - 11-50
                          - 51-200
                          - 201-500
                          - 501-1000
                          - 1001-5000
                          - 5001-10000
                          - 10001+
                      description: Exact matches for the employee range search
                      maxItems: 50
                      type: array
                      items:
                        type: string
                        enum:
                          - 1-10
                          - 11-50
                          - 51-200
                          - 201-500
                          - 501-1000
                          - 1001-5000
                          - 5001-10000
                          - 10001+
                    employee_count:
                      description: >-
                        Range search on the company's employee count (the
                        `employees_on_linkedin` value returned in results)
                      type: object
                      properties:
                        min:
                          default: 0
                          examples:
                            - 0
                          description: Lowest value to match. 0 means no lower bound.
                          type: number
                          minimum: 0
                          maximum: 980000
                        max:
                          default: 0
                          examples:
                            - 0
                          description: Highest value to match. 0 means no upper bound.
                          type: number
                          minimum: 0
                          maximum: 1000000
                      additionalProperties: false
                    min_linkedin_followers:
                      default: 0
                      examples:
                        - 0
                      description: Minimum number of LinkedIn followers
                      type: number
                      minimum: 0
                      maximum: 10000000
                    revenue:
                      description: >-
                        Range search for company revenue (USD). Matches
                        companies whose revenue band overlaps the requested
                        range. 0 = unset.
                      type: object
                      properties:
                        min:
                          default: 0
                          examples:
                            - 0
                          description: Lowest value to match. 0 means no lower bound.
                          type: number
                          minimum: 0
                          maximum: 9007199254740991
                        max:
                          default: 0
                          examples:
                            - 0
                          description: Highest value to match. 0 means no upper bound.
                          type: number
                          minimum: 0
                          maximum: 9007199254740991
                      additionalProperties: false
                    naics_code:
                      description: Exact matches for NAICS codes
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - - '541511'
                          description: >-
                            NAICS codes to keep. A company matches when its code
                            is any listed code.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            minLength: 1
                        exclude:
                          default: []
                          examples:
                            - []
                          description: >-
                            NAICS codes to drop. A company is removed when its
                            code is any listed code.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            minLength: 1
                      additionalProperties: false
                    sic_code:
                      description: Exact matches for SIC codes
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - - '7372'
                          description: >-
                            SIC codes to keep. A company matches when its code
                            is any listed code.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            minLength: 1
                        exclude:
                          default: []
                          examples:
                            - []
                          description: >-
                            SIC codes to drop. A company is removed when its
                            code is any listed code.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            minLength: 1
                      additionalProperties: false
                    mx:
                      description: >-
                        Mail provider of the company, from the MX records of its
                        domains. Companies with no MX data are never matched by
                        `include` and `exclude` never drops them, unless you use
                        `any`.
                      type: object
                      properties:
                        provider:
                          description: >-
                            Known mail providers, such as `google` or
                            `microsoft`. A company matches when any of its
                            domains uses the provider. `any` stands for every
                            provider: in `include` it keeps companies with MX
                            data, in `exclude` it keeps companies with no MX
                            data. Use `include: ["any"], exclude: ["google"]`
                            for companies with MX data that do not use Google.
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - - google
                              description: >-
                                Mail providers to keep. Use `any` to keep every
                                company that has MX data.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - any
                                  - google
                                  - microsoft
                                  - zoho
                                  - godaddy
                                  - proofpoint
                                  - mimecast
                                  - barracuda
                                  - cloudflare
                                  - ionos
                                  - hostinger
                                  - namecheap
                                  - fastmail
                                  - proton
                                  - strato
                                  - ovh
                                  - siteground
                                  - opensrs
                                  - one_com
                                  - tencent
                                  - titan
                                  - 20i
                                  - rackspace
                                  - alibaba
                                  - open_xchange
                                  - infomaniak
                                  - jimdo
                                  - netease
                                  - gandi
                                  - register_it
                                  - hetzner
                                  - yahoo
                                  - amazon
                                  - yandex
                                  - locaweb
                                  - uol_host
                                  - fasthosts
                                  - kinghost
                                  - t_online
                                  - hostopia
                                  - united_domains
                                  - hostpoint
                                  - mijndomein
                                  - icloud
                                  - reg123
                                  - mailhostbox
                                  - transip
                                  - natro
                                  - names_co_uk
                                  - intermedia
                                  - hostnet
                                  - aruba
                                  - loopia
                                  - netcup
                                  - lolipop
                                  - simply
                                  - domeneshop
                                  - hornetsecurity
                                  - mailchannels
                                  - appriver
                                  - trendmicro
                                  - spamexperts
                                  - cisco
                                  - sophos
                                  - mesh
                                  - mailinblack
                            exclude:
                              default: []
                              examples:
                                - []
                              description: >-
                                Mail providers to drop. Use `any` to keep only
                                companies that have no MX data.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - any
                                  - google
                                  - microsoft
                                  - zoho
                                  - godaddy
                                  - proofpoint
                                  - mimecast
                                  - barracuda
                                  - cloudflare
                                  - ionos
                                  - hostinger
                                  - namecheap
                                  - fastmail
                                  - proton
                                  - strato
                                  - ovh
                                  - siteground
                                  - opensrs
                                  - one_com
                                  - tencent
                                  - titan
                                  - 20i
                                  - rackspace
                                  - alibaba
                                  - open_xchange
                                  - infomaniak
                                  - jimdo
                                  - netease
                                  - gandi
                                  - register_it
                                  - hetzner
                                  - yahoo
                                  - amazon
                                  - yandex
                                  - locaweb
                                  - uol_host
                                  - fasthosts
                                  - kinghost
                                  - t_online
                                  - hostopia
                                  - united_domains
                                  - hostpoint
                                  - mijndomein
                                  - icloud
                                  - reg123
                                  - mailhostbox
                                  - transip
                                  - natro
                                  - names_co_uk
                                  - intermedia
                                  - hostnet
                                  - aruba
                                  - loopia
                                  - netcup
                                  - lolipop
                                  - simply
                                  - domeneshop
                                  - hornetsecurity
                                  - mailchannels
                                  - appriver
                                  - trendmicro
                                  - spamexperts
                                  - cisco
                                  - sophos
                                  - mesh
                                  - mailinblack
                          additionalProperties: false
                      additionalProperties: false
                    web_traffic:
                      description: >-
                        Range search for total monthly web traffic (visits). 0 =
                        unset.
                      type: object
                      properties:
                        min:
                          default: 0
                          examples:
                            - 0
                          description: Lowest value to match. 0 means no lower bound.
                          type: number
                          minimum: 0
                          maximum: 2147483647
                        max:
                          default: 0
                          examples:
                            - 0
                          description: Highest value to match. 0 means no upper bound.
                          type: number
                          minimum: 0
                          maximum: 2147483647
                      additionalProperties: false
                    ad_spend:
                      description: >-
                        Range search for monthly Google ad spend, as a whole
                        amount per month. The data records no currency.
                      type: object
                      properties:
                        min:
                          default: 0
                          examples:
                            - 0
                          description: >-
                            Lowest monthly Google ad spend to match, inclusive.
                            0 means no lower bound.
                          type: number
                          minimum: 0
                          maximum: 1000000000000
                        max:
                          default: 0
                          examples:
                            - 0
                          description: >-
                            Highest monthly Google ad spend to match, inclusive.
                            0 means no upper bound.
                          type: number
                          minimum: 0
                          maximum: 1000000000000
                      additionalProperties: false
                    total_funding:
                      description: Range search for total funding amount (USD). 0 = unset.
                      type: object
                      properties:
                        min:
                          default: 0
                          examples:
                            - 0
                          description: Lowest value to match. 0 means no lower bound.
                          type: number
                          minimum: 0
                          maximum: 1000000000000
                        max:
                          default: 0
                          examples:
                            - 0
                          description: Highest value to match. 0 means no upper bound.
                          type: number
                          minimum: 0
                          maximum: 1000000000000
                      additionalProperties: false
                    last_funding_amount:
                      description: >-
                        Range search for the last funding round amount (USD). 0
                        = unset.
                      type: object
                      properties:
                        min:
                          default: 0
                          examples:
                            - 0
                          description: Lowest value to match. 0 means no lower bound.
                          type: number
                          minimum: 0
                          maximum: 1000000000000
                        max:
                          default: 0
                          examples:
                            - 0
                          description: Highest value to match. 0 means no upper bound.
                          type: number
                          minimum: 0
                          maximum: 1000000000000
                      additionalProperties: false
                    last_funding_year:
                      description: >-
                        Range search for the year of the last funding round. 0 =
                        unset, otherwise 1800 to 2026.
                      type: object
                      properties:
                        min:
                          default: 0
                          examples:
                            - 0
                          description: Lowest value to match. 0 means no lower bound.
                          type: number
                          minimum: 0
                          maximum: 2026
                        max:
                          default: 0
                          examples:
                            - 0
                          description: Highest value to match. 0 means no upper bound.
                          type: number
                          minimum: 0
                          maximum: 2026
                      additionalProperties: false
                    last_funding_type:
                      description: Exact matches for the last funding round type
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - - Series A
                          description: >-
                            Funding round types to keep. A company matches when
                            its last round is any listed type.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            enum:
                              - Series unknown
                              - Pre seed
                              - Seed
                              - Series A
                              - Series B
                              - Series C
                              - Series D
                              - Series E-J
                              - Grant
                              - Angel
                              - Private equity
                              - Debt financing
                              - Non equity assistance
                              - Post IPO equity
                              - Undisclosed
                              - Post IPO debt
                              - Product crowdfunding
                              - Equity crowdfunding
                              - Corporate round
                              - Convertible note
                              - Secondary market
                              - Initial coin offering
                              - Post IPO secondary
                        exclude:
                          default: []
                          examples:
                            - []
                          description: >-
                            Funding round types to drop. A company is removed
                            when its last round is any listed type.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                            enum:
                              - Series unknown
                              - Pre seed
                              - Seed
                              - Series A
                              - Series B
                              - Series C
                              - Series D
                              - Series E-J
                              - Grant
                              - Angel
                              - Private equity
                              - Debt financing
                              - Non equity assistance
                              - Post IPO equity
                              - Undisclosed
                              - Post IPO debt
                              - Product crowdfunding
                              - Equity crowdfunding
                              - Corporate round
                              - Convertible note
                              - Secondary market
                              - Initial coin offering
                              - Post IPO secondary
                      additionalProperties: false
                    lead_investors:
                      description: Keywords searched in lead investor names
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - - Sequoia
                          description: >-
                            Keywords to keep. A record matches when it has all
                            the words of at least one keyword.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                        exclude:
                          default: []
                          examples:
                            - []
                          description: >-
                            Keywords to drop. A record is removed when it has
                            all the words of any one keyword.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                      additionalProperties: false
                    keywords:
                      description: >-
                        Keywords searched across the company description,
                        specialties, NAICS/SIC descriptions, and Crunchbase/G2
                        categories. A phrase matches a company if all its tokens
                        are found within any one of those fields.
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - - Tech
                          description: >-
                            Keywords to keep. A record matches when it has all
                            the words of at least one keyword.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                        exclude:
                          default: []
                          examples:
                            - - Finance
                              - Marketing
                          description: >-
                            Keywords to drop. A record is removed when it has
                            all the words of any one keyword.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                      additionalProperties: false
                    founded_year:
                      description: Range search for the year the company was founded
                      type: object
                      properties:
                        min:
                          default: 0
                          examples:
                            - 0
                          description: Lowest value to match. 0 means no lower bound.
                          type: number
                          minimum: 0
                          maximum: 1000000000
                        max:
                          default: 0
                          examples:
                            - 0
                          description: Highest value to match. 0 means no upper bound.
                          type: number
                          minimum: 0
                          maximum: 1000000000
                      additionalProperties: false
                    hq:
                      description: Location of the headquarters of the company
                      type: object
                      properties:
                        city:
                          description: >-
                            Keywords searched to find the headquarters city of
                            the company
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - - City
                              description: >-
                                Keywords to keep. A record matches when it has
                                all the words of at least one keyword.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                minLength: 1
                            exclude:
                              default: []
                              examples:
                                - - New
                              description: >-
                                Keywords to drop. A record is removed when it
                                has all the words of any one keyword.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                minLength: 1
                          additionalProperties: false
                        state:
                          description: >-
                            Keywords searched to find the headquarters
                            state/province of the company
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - - California
                              description: >-
                                Keywords to keep. A record matches when it has
                                all the words of at least one keyword.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                minLength: 1
                            exclude:
                              default: []
                              examples:
                                - - Texas
                              description: >-
                                Keywords to drop. A record is removed when it
                                has all the words of any one keyword.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                minLength: 1
                          additionalProperties: false
                        country_code:
                          description: >-
                            Countries of the headquarters of the company,
                            matched on the country code. A plain list is still
                            accepted and is read as `include`.
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - []
                              description: >-
                                Two-letter ISO 3166-1 country codes of the
                                headquarters to keep, such as `FR` or `GB`.
                                Letter case does not matter, and `UK` is read as
                                `GB`. A company with no country on file never
                                matches. `WORLD` means every country.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                            exclude:
                              default: []
                              examples:
                                - []
                              description: >-
                                Two-letter ISO 3166-1 country codes of the
                                headquarters to drop. Letter case does not
                                matter, and `UK` is read as `GB`. A company with
                                no country on file is never dropped.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                minLength: 2
                                maxLength: 2
                          additionalProperties: false
                        continent:
                          description: >-
                            Continents of the headquarters of the company. A
                            plain list is still accepted and is read as
                            `include`.
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - []
                              description: >-
                                Continents of the headquarters to keep. A
                                company matches when its headquarters is on any
                                of them.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - Africa
                                  - Antarctica
                                  - Asia
                                  - Europe
                                  - North America
                                  - Oceania
                                  - South America
                            exclude:
                              default: []
                              examples:
                                - []
                              description: >-
                                Continents of the headquarters to drop. A
                                company is removed when its headquarters is on
                                any of them. A company with no continent on file
                                is never dropped.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - Africa
                                  - Antarctica
                                  - Asia
                                  - Europe
                                  - North America
                                  - Oceania
                                  - South America
                          additionalProperties: false
                        sales_region:
                          description: >-
                            Sales regions of the headquarters of the company. A
                            plain list is still accepted and is read as
                            `include`.
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - []
                              description: >-
                                Sales regions of the headquarters to keep. A
                                company matches when its headquarters is in any
                                of them. `NORAM` is North America, `LATAM` Latin
                                America, `EMEA` Europe, Middle East and Africa,
                                `APAC` Asia-Pacific.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - NORAM
                                  - LATAM
                                  - EMEA
                                  - APAC
                            exclude:
                              default: []
                              examples:
                                - []
                              description: >-
                                Sales regions of the headquarters to drop. A
                                company is removed when its headquarters is in
                                any of them. A company with no sales region on
                                file is never dropped.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - NORAM
                                  - LATAM
                                  - EMEA
                                  - APAC
                          additionalProperties: false
                      additionalProperties: false
                  additionalProperties: false
                people:
                  description: People search criteria for company matching
                  type: object
                  properties:
                    linkedin_url:
                      description: >-
                        Exact matches for the LinkedIn URL of the person, to
                        find specific people
                      type: array
                      items:
                        type: string
                        examples:
                          - https://www.linkedin.com/in/antoine-blitz-5581b7373
                      maxItems: 50
                    job_title:
                      description: >-
                        Find at least one person with the given job title in the
                        company. Values match as a keyword search by default;
                        wrap a value in square brackets (`"[CEO]"`) to require
                        an exact, case- and accent-insensitive match. See [Field
                        normalization](/guide/reference/normalization/filters#exact-match-syntax).
                      type: object
                      properties:
                        include_linkedin_headline:
                          default: false
                          examples:
                            - false
                          description: >-
                            Whether to include the LinkedIn headline in the
                            job_title search
                          type: boolean
                        include:
                          default: []
                          examples:
                            - - Software Engineer
                          description: >-
                            Job titles to look for. A person matches when a job
                            title has all the words of at least one phrase. Put
                            a phrase in square brackets, such as `[Head of
                            Sales]`, to match the whole title exactly, ignoring
                            case and accents.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                        exclude:
                          default: []
                          examples:
                            - - CTO
                          description: >-
                            Job titles to drop. A person is removed when a job
                            title matches any phrase. Square brackets work as in
                            `include`.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                      additionalProperties: false
                    job_description:
                      description: >-
                        Find at least one person whose job description matches.
                        It applies to the same job as the job title and company
                        filters. Only the first 10,000 characters of a
                        description are searched.
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - - Salesforce
                              - outbound prospecting
                          description: >-
                            Phrases to match against the job description. Every
                            word of a phrase must appear in the description, in
                            any order. Multiple phrases are OR-ed. Unlike
                            job_title, [brackets] give no exact match: [Sales]
                            is searched as Sales.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                        exclude:
                          default: []
                          examples:
                            - - internship
                          description: >-
                            Phrases to exclude from the job description. Every
                            word of a phrase must appear for the job to be
                            excluded. A job with no description is never
                            excluded.
                          maxItems: 20
                          type: array
                          items:
                            type: string
                      additionalProperties: false
                    job_function:
                      default: []
                      examples:
                        - - Advertising & Marketing
                      description: Exact matches for the job function search
                      maxItems: 50
                      type: array
                      items:
                        type: string
                        enum:
                          - Advertising & Marketing
                          - Art, Culture and Creative Professionals
                          - Construction
                          - Customer/Client Service
                          - Education
                          - Engineering
                          - Finance & Accounting
                          - General Business & Management
                          - Healthcare & Human Services
                          - Human Resources
                          - Information Technology
                          - Legal
                          - Manufacturing & Production
                          - Operations
                          - Other
                          - Public Administration & Safety
                          - Purchasing
                          - Research & Development
                          - Sales & Business Development
                          - Science
                          - Supply Chain & Logistics
                          - Writing/Editing
                    job_level:
                      examples:
                        - - VP
                          - Director
                      description: Exact matches for the job level search
                      maxItems: 50
                      type: array
                      items:
                        type: string
                        enum:
                          - C-Team
                          - Director
                          - Manager
                          - Other
                          - Staff
                          - VP
                    min_connections:
                      default: 0
                      examples:
                        - 500
                      description: Minimum number of LinkedIn connections to find
                      type: number
                      minimum: 0
                      maximum: 500
                    is_recent_hire:
                      default: false
                      examples:
                        - false
                      description: >-
                        Only people with a job that started in the last 90 days.
                        The job must also match the other job and company
                        filters. A job with no start date never matches.
                      type: boolean
                    location:
                      description: Location of the people to find
                      type: object
                      properties:
                        city:
                          description: >-
                            Keywords searched to find the city where the person
                            is based
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - - Paris
                                  - London
                              description: >-
                                Keywords to keep. A record matches when it has
                                all the words of at least one keyword.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                minLength: 1
                            exclude:
                              default: []
                              examples:
                                - - Remote
                              description: >-
                                Keywords to drop. A record is removed when it
                                has all the words of any one keyword.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                minLength: 1
                          additionalProperties: false
                        country_code:
                          description: >-
                            Countries where the people live, matched on the
                            country code. A plain list is still accepted and is
                            read as `include`.
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - - FR
                                  - GB
                              description: >-
                                Two-letter ISO 3166-1 country codes of the
                                people to keep, such as `FR` or `GB`. Letter
                                case does not matter, and `UK` is read as `GB`.
                                A person with no country on file never matches.
                                `WORLD` means every country.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                            exclude:
                              default: []
                              examples:
                                - - US
                              description: >-
                                Two-letter ISO 3166-1 country codes of the
                                people to drop. Letter case does not matter, and
                                `UK` is read as `GB`. A person with no country
                                on file is never dropped.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                minLength: 2
                                maxLength: 2
                          additionalProperties: false
                        continent:
                          description: >-
                            Continents where the people live. A plain list is
                            still accepted and is read as `include`.
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - - Europe
                              description: >-
                                Continents where the people live. A person
                                matches when their location is on any of them.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - Africa
                                  - Antarctica
                                  - Asia
                                  - Europe
                                  - North America
                                  - Oceania
                                  - South America
                            exclude:
                              default: []
                              examples:
                                - []
                              description: >-
                                Continents to drop. A person is removed when
                                their location is on any of them. A person with
                                no continent on file is never dropped.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - Africa
                                  - Antarctica
                                  - Asia
                                  - Europe
                                  - North America
                                  - Oceania
                                  - South America
                          additionalProperties: false
                        sales_region:
                          description: >-
                            Sales regions where the people live. A plain list is
                            still accepted and is read as `include`.
                          type: object
                          properties:
                            include:
                              default: []
                              examples:
                                - - EMEA
                              description: >-
                                Sales regions where the people live. A person
                                matches when their location is in any of them.
                                `NORAM` is North America, `LATAM` Latin America,
                                `EMEA` Europe, Middle East and Africa, `APAC`
                                Asia-Pacific.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - NORAM
                                  - LATAM
                                  - EMEA
                                  - APAC
                            exclude:
                              default: []
                              examples:
                                - []
                              description: >-
                                Sales regions to drop. A person is removed when
                                their location is in any of them. A person with
                                no sales region on file is never dropped.
                              maxItems: 50
                              type: array
                              items:
                                type: string
                                enum:
                                  - NORAM
                                  - LATAM
                                  - EMEA
                                  - APAC
                          additionalProperties: false
                      additionalProperties: false
                    education:
                      description: >-
                        Education filter for the person. Phrases are matched
                        against each education entry independently: tokens
                        within a phrase must co-occur inside a single entry
                        (school, degree, dates), so a phrase like "Stanford
                        2025" matches a person who studied at Stanford ending in
                        2025, not someone with separate Stanford and 2025
                        entries.
                      type: object
                      properties:
                        include:
                          default: []
                          examples:
                            - - Stanford CS 2025
                              - MIT
                          description: >-
                            Phrases matched against education entries. Tokens
                            must co-occur within a single entry, so wrap the
                            year in the phrase (e.g. "Stanford 2025") to
                            correlate school and year. Token order is not
                            significant ("Stanford CS" matches "CS Stanford").
                            Multiple phrases are OR-ed.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                        exclude:
                          default: []
                          examples:
                            - - Bootcamp
                          description: >-
                            Phrases excluded from education entries: any person
                            with an entry matching one of these phrases is
                            filtered out.
                          maxItems: 50
                          type: array
                          items:
                            type: string
                        start_year:
                          description: >-
                            Range search for the year an education entry
                            started. 0 = unset. Applies to the same entry as
                            include; an entry with no start year never matches a
                            bound.
                          type: object
                          properties:
                            min:
                              default: 0
                              examples:
                                - 2016
                              description: Lowest value to match. 0 means no lower bound.
                              type: integer
                              minimum: 0
                              maximum: 2100
                            max:
                              default: 0
                              examples:
                                - 2020
                              description: Highest value to match. 0 means no upper bound.
                              type: integer
                              minimum: 0
                              maximum: 2100
                          additionalProperties: false
                        end_year:
                          description: >-
                            Range search for the year an education entry ended
                            (graduation year). 0 = unset. Applies to the same
                            entry as include; an entry with no end year never
                            matches a bound.
                          type: object
                          properties:
                            min:
                              default: 0
                              examples:
                                - 2018
                              description: Lowest value to match. 0 means no lower bound.
                              type: integer
                              minimum: 0
                              maximum: 2100
                            max:
                              default: 0
                              examples:
                                - 2022
                              description: Highest value to match. 0 means no upper bound.
                              type: integer
                              minimum: 0
                              maximum: 2100
                          additionalProperties: false
                      additionalProperties: false
                    min_per_company:
                      default: 0
                      examples:
                        - 0
                      description: >-
                        Only return companies with at least this many matching
                        employees (max 25). 0 = unset.
                      type: number
                      minimum: 0
                      maximum: 25
                  additionalProperties: false
                max_results:
                  default: 10
                  examples:
                    - 10
                  description: Maximum number of results to return
                  type: number
                  minimum: 1
                  maximum: 50
                cursor:
                  default: null
                  examples:
                    - null
                  description: Cursor to paginate through the results
                  anyOf:
                    - type: string
                      minLength: 3
                    - type: 'null'
              additionalProperties: false
              example:
                company:
                  linkedin_url: []
                  name:
                    include: []
                    exclude: []
                  industry:
                    include: []
                    exclude: []
                  type:
                    include: []
                    exclude: []
                  employee_range:
                    - 1-10
                    - 11-50
                    - 51-200
                    - 201-500
                    - 501-1000
                    - 1001-5000
                    - 5001-10000
                    - 10001+
                  employee_count:
                    min: 1
                    max: 0
                  min_linkedin_followers: 1
                  revenue:
                    min: 0
                    max: 0
                  naics_code:
                    include: []
                    exclude: []
                  sic_code:
                    include: []
                    exclude: []
                  web_traffic:
                    min: 0
                    max: 0
                  ad_spend:
                    min: 0
                    max: 0
                  total_funding:
                    min: 0
                    max: 0
                  last_funding_amount:
                    min: 0
                    max: 0
                  last_funding_year:
                    min: 0
                    max: 0
                  last_funding_type:
                    include: []
                    exclude: []
                  lead_investors:
                    include: []
                    exclude: []
                  keywords:
                    include: []
                    exclude: []
                  founded_year:
                    min: 0
                    max: 0
                  hq:
                    city:
                      include: []
                      exclude: []
                    country_code:
                      include: []
                      exclude: []
                    continent:
                      include: []
                      exclude: []
                    sales_region:
                      include: []
                      exclude: []
                people:
                  job_title:
                    include_linkedin_headline: false
                    include: []
                    exclude: []
                  job_function: []
                  job_level: []
                  min_connections: 500
                  location:
                    city:
                      include: []
                      exclude: []
                    country_code:
                      include:
                        - US
                      exclude: []
                    continent:
                      include: []
                      exclude: []
                    sales_region:
                      include: []
                      exclude: []
                  education:
                    include: []
                    exclude: []
                max_results: 3
                cursor: null
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        company:
                          type: object
                          properties:
                            linkedin_url:
                              anyOf:
                                - type: string
                                - type: 'null'
                            linkedin_id:
                              anyOf:
                                - type: number
                                - type: 'null'
                            name:
                              anyOf:
                                - type: string
                                - type: 'null'
                            about:
                              anyOf:
                                - type: string
                                - type: 'null'
                            specialties:
                              anyOf:
                                - anyOf:
                                    - type: array
                                      items:
                                        type: string
                                    - type: 'null'
                                - type: 'null'
                            industry:
                              anyOf:
                                - type: string
                                - type: 'null'
                            type:
                              anyOf:
                                - type: string
                                - type: 'null'
                            size:
                              anyOf:
                                - type: string
                                - type: 'null'
                            revenue_range:
                              anyOf:
                                - type: string
                                - type: 'null'
                              description: >-
                                Label of the company's yearly revenue band, such
                                as `$10M-$50M`. `null` when the band is unknown.
                            employees_on_linkedin:
                              anyOf:
                                - type: number
                                - type: 'null'
                            followers:
                              anyOf:
                                - type: number
                                - type: 'null'
                            founded_year:
                              anyOf:
                                - type: number
                                - type: 'null'
                            hq:
                              anyOf:
                                - type: object
                                  properties:
                                    city:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    state:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    country_code:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    country_name:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    region:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    continent:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                  required:
                                    - city
                                    - state
                                    - country_code
                                    - country_name
                                    - region
                                    - continent
                                  additionalProperties: false
                                  examples:
                                    - city: Noida
                                      state: Uttar Pradesh
                                      country_code: IN
                                      country_name: India
                                      region: APAC
                                      continent: Asia
                                - type: 'null'
                            domain:
                              anyOf:
                                - type: string
                                - type: 'null'
                            website:
                              anyOf:
                                - type: string
                                - type: 'null'
                          required:
                            - linkedin_url
                            - linkedin_id
                            - name
                            - about
                            - specialties
                            - industry
                            - type
                            - size
                            - revenue_range
                            - employees_on_linkedin
                            - followers
                            - founded_year
                            - hq
                            - domain
                            - website
                          additionalProperties: false
                          examples:
                            - linkedin_url: https://www.linkedin.com/company/xxx
                              linkedin_id: 10509138
                              name: Company Name
                              about: Short company description / about us…
                              specialties:
                                - graphisme
                                - conseils communication
                                - web
                              industry: Advertising Services
                              type: Privately Held
                              size: 1-10
                              revenue_range: <$1M
                              employees_on_linkedin: 2
                              followers: 58
                              founded_year: 2003
                              hq:
                                city: Noida
                                state: Uttar Pradesh
                                country_code: IN
                                country_name: India
                                region: APAC
                                continent: Asia
                              domain: communication-support.be
                              website: https://www.communication-support.be
                        matched_people:
                          type: number
                          description: >-
                            Number of current employees matching the filter at
                            this company
                          examples:
                            - 3
                      required:
                        - company
                        - matched_people
                      additionalProperties: false
                  results_length:
                    type: number
                    examples:
                      - 3
                  max_results:
                    type: number
                    examples:
                      - 3
                  cursor:
                    anyOf:
                      - type: string
                      - type: 'null'
                    examples:
                      - null
                  fair_usage:
                    type: object
                    description: >-
                      Record usage, rate limit, and tracing data for this
                      request.
                    properties:
                      records_used:
                        type: number
                        description: >-
                          Records this request consumed, after reconciliation
                          against the results actually returned.
                        examples:
                          - 3
                      records_remaining:
                        anyOf:
                          - type: number
                          - type: string
                            const: unlimited
                        description: Records left on the plan after this request.
                        examples:
                          - 9913547
                      next_reset_at:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: >-
                          When the record balance resets. Null when the plan has
                          no reset date.
                        examples:
                          - '2026-09-29T10:25:23.155Z'
                      rate_limit:
                        type: object
                        description: Absent on endpoints that are not rate limited.
                        properties:
                          requests_per_second:
                            type: number
                            description: >-
                              Requests your account may send per second on this
                              endpoint, shared by all its API keys. Set by your
                              plan.
                            examples:
                              - 10
                          remaining_this_second:
                            type: number
                            description: Requests left in the current one-second window.
                            examples:
                              - 9
                        required:
                          - requests_per_second
                          - remaining_this_second
                        additionalProperties: false
                      request_id:
                        type: string
                        description: Quote this id when you contact support.
                        examples:
                          - 019bae09-0055-7441-b2ea-16086e499219
                    required:
                      - records_used
                      - records_remaining
                      - next_reset_at
                      - request_id
                    additionalProperties: false
                required:
                  - results
                  - results_length
                  - max_results
                  - cursor
                additionalProperties: false
              example:
                results:
                  - company:
                      linkedin_url: https://www.linkedin.com/company/google
                      linkedin_id: 1441
                      name: Google
                      about: >-
                        A problem isn\'t truly solved until it\'s solved for
                        all. Googlers build products that help create
                        opportunities for everyone, whether down the street or
                        across the globe. Bring your insight, imagination and a
                        healthy disregard for the impossible. Bring everything
                        that makes you unique. Together, we can build for
                        everyone. Check out our career opportunities at
                        goo.gle/3DLEokh
                      specialties:
                        - mobile
                        - hardware
                        - youtube
                        - machine learning
                        - artificial intelligence
                        - software
                        - search
                        - apps
                        - cloud
                        - online video
                        - virtual reality
                        - roid
                        - ads
                      industry: Software Development
                      type: Public Company
                      size: 10001+
                      revenue_range: $1B+
                      employees_on_linkedin: 328177
                      followers: 40093219
                      founded_year: null
                      hq:
                        city: Mountain View
                        state: California
                        country_code: US
                        country_name: United States
                        region: NORAM
                        continent: North America
                      domain: google.com
                      website: https://www.google.com
                    matched_people: 42
                  - company:
                      linkedin_url: https://www.linkedin.com/company/amazon
                      linkedin_id: 1586
                      name: Amazon
                      about: >-
                        Amazon is guided by four principles: customer obsession
                        rather than competitor focus, passion for invention,
                        commitment to operational excellence, and long-term
                        thinking. We are driven by the excitement of building
                        technologies, inventing products, and providing services
                        that change lives. We embrace new ways of doing things,
                        make decisions quickly, and are not afraid to fail. We
                        have the scope and capabilities of a large company, and
                        the spirit and heart of a small one. Together,
                        Amazonians research and develop new technologies from
                        Amazon Web Services to Alexa on behalf of our customers:
                        shoppers, sellers, content creators, and developers
                        around the world. Our mission is to be Earth\'s most
                        customer-centric company. Our actions, goals, projects,
                        programs, and inventions begin and end with the customer
                        top of mind. You\'ll also hear us say that at Amazon,
                        it\'s always \"Day 1.\" What do we mean? That our
                        approach remains the same as it was on Amazon\'s very
                        first day - to make smart, fast decisions, stay nimble,
                        invent, and focus on delighting our customers.
                      specialties:
                        - operations
                        - internet
                        - retail
                        - e-commerce
                      industry: Software Development
                      type: Public Company
                      size: 10001+
                      revenue_range: $1B+
                      employees_on_linkedin: 778681
                      followers: 35961516
                      founded_year: null
                      hq:
                        city: Seattle
                        state: Washington
                        country_code: US
                        country_name: United States
                        region: NORAM
                        continent: North America
                      domain: amazon.com
                      website: https://www.amazon.com
                    matched_people: 27
                  - company:
                      linkedin_url: https://www.linkedin.com/company/1337
                      linkedin_id: 1337
                      name: Linkedin
                      about: >-
                        Founded in 2003, LinkedIn connects the world\'s
                        professionals to make them more productive and
                        successful. With more than 1 billion members worldwide,
                        including executives from every Fortune 500 company,
                        LinkedIn is the world\'s largest professional network.
                        The company has a diversified business model with
                        revenue coming from Talent Solutions, Marketing
                        Solutions, Sales Solutions and Premium Subscriptions
                        products. Headquartered in Silicon Valley, LinkedIn has
                        offices across the globe.
                      specialties:
                        - address book
                        - recruiting
                        - people search
                        - group collaboration
                        - online professional network
                        - company search
                        - jobs
                        - professional identity
                        - advertising
                      industry: Software Development
                      type: Public Company
                      size: 10001+
                      revenue_range: $1B+
                      employees_on_linkedin: 23910
                      followers: 32612546
                      founded_year: null
                      hq:
                        city: Sunnyvale
                        state: California
                        country_code: US
                        country_name: United States
                        region: NORAM
                        continent: North America
                      domain: null
                      website: https://www.linkedin.com
                    matched_people: 4
                results_length: 3
                max_results: 3
                cursor: eyJvZmZzZXQiOjN9
                fair_usage:
                  records_used: 3
                  records_remaining: 9913547
                  next_reset_at: '2026-09-29T10:25:23.155Z'
                  rate_limit:
                    requests_per_second: 10
                    remaining_this_second: 9
                  request_id: 019bae09-0055-7441-b2ea-16086e499219
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                example:
                  success: false
                  message: >-
                    The request body is not valid JSON. Send a JSON object with
                    the header Content-Type: application/json.
                  fair_usage:
                    records_used: 0
                    request_id: 019bae09-0055-7441-b2ea-16086e499219
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  success: false
                  message: >-
                    Invalid API key, please provide a valid API key in the
                    'x-api-key' header
                  fair_usage:
                    records_used: 0
                    request_id: 019bae09-0055-7441-b2ea-16086e499219
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                example:
                  success: false
                  message: >-
                    Fair Use limit reached. Upgrade your plan at
                    app.blitz-api.ai/billing or contact support to increase your
                    monthly capacity.
                  fair_usage:
                    records_used: 0
                    records_remaining: 0
                    next_reset_at: '2026-09-29T10:25:23.155Z'
                    rate_limit:
                      requests_per_second: 10
                      remaining_this_second: 9
                    request_id: 019bae09-0055-7441-b2ea-16086e499219
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                example:
                  success: false
                  message: Not Found
                  fair_usage:
                    records_used: 0
                    request_id: 019bae09-0055-7441-b2ea-16086e499219
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
              example:
                success: false
                message: >-
                  Invalid request body. people.min_per_company: Must be at most
                  25 (got 50).
                errors:
                  - field: people.min_per_company
                    message: Must be at most 25 (got 50).
                fair_usage:
                  records_used: 0
                  request_id: 019bae09-0055-7441-b2ea-16086e499219
        '423':
          description: Locked
          content:
            application/json:
              schema:
                type: object
                example:
                  blocked: true
                  message: >-
                    Your account was locked, we detected unusual behavior.
                    Please contact our support to unlock your account.
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                example:
                  success: false
                  message: Rate limit exceeded, please try again later
                  fair_usage:
                    records_used: 0
                    request_id: 019bae09-0055-7441-b2ea-16086e499219
        '503':
          description: Service Unavailable. Retry the request; no record is charged.
          content:
            application/json:
              schema:
                type: object
              examples:
                search:
                  summary: The search did not complete
                  value:
                    success: false
                    found: false
                    message: Service temporarily unavailable, please try again
                    fair_usage:
                      records_used: 0
                      request_id: 019bae09-0055-7441-b2ea-16086e499219
                billing:
                  summary: The billing check is unavailable
                  value:
                    success: false
                    message: Billing temporarily unavailable, please try again
                    fair_usage:
                      records_used: 0
                      request_id: 019bae09-0055-7441-b2ea-16086e499219
                auth:
                  summary: The API key check is unavailable
                  value:
                    success: false
                    message: Service temporarily unavailable, please try again
                    fair_usage:
                      records_used: 0
                      request_id: 019bae09-0055-7441-b2ea-16086e499219
      security:
        - APIKey: []
components:
  schemas:
    ValidationError:
      type: object
      description: >-
        The request body has an unknown field or an invalid value. The request
        did not run and used no records.
      required:
        - success
        - message
        - errors
      properties:
        success:
          type: boolean
          description: Always `false`.
        message:
          type: string
          description: >-
            One-line summary of the first three errors, for logs. The wording
            can change, so read `errors` to find what to fix.
        errors:
          type: array
          maxItems: 20
          description: One item per problem, up to 20.
          items:
            type: object
            required:
              - field
              - message
            properties:
              field:
                type: string
                description: >-
                  Path to the problem. Dots mark nesting and `[n]` marks an
                  array item, e.g. `company.industry.include[0]`. For an unknown
                  field, this is the full path to the unknown key, e.g.
                  `company.industry.includes`, or `company_url` for a top-level
                  field.
              message:
                type: string
                description: >-
                  What is wrong. When the input is close to a valid field or
                  value, it suggests the closest match. Otherwise a short list
                  of allowed fields or values is given in full.
        fair_usage:
          $ref: '#/components/schemas/ErrorFairUsage'
    ErrorFairUsage:
      type: object
      properties:
        records_used:
          type: number
          description: >-
            Records this request consumed, after reconciliation against the
            results actually returned.
          examples:
            - 3
        records_remaining:
          anyOf:
            - type: number
            - type: string
              const: unlimited
          description: Records left on the plan after this request.
          examples:
            - 9913547
        next_reset_at:
          description: When the record balance resets. Null on an unlimited plan.
          examples:
            - '2026-09-29T10:25:23.155Z'
          type:
            - string
            - 'null'
        rate_limit:
          description: Absent on endpoints that are not rate limited.
          type: object
          properties:
            requests_per_second:
              type: number
              description: Requests this API key may send per second.
              examples:
                - 100
            remaining_this_second:
              type: number
              description: Requests left in the current one-second window.
              examples:
                - 97
          required:
            - requests_per_second
            - remaining_this_second
          additionalProperties: false
        request_id:
          type: string
          description: Quote this id when you contact support.
          examples:
            - 019bae09-0055-7441-b2ea-16086e499219
      required:
        - records_used
        - request_id
      additionalProperties: false
      description: >-
        Record usage, rate limit, and tracing data for this request.
        records_remaining and next_reset_at are absent when the request stopped
        before the plan was read.
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your BlitzAPI key. Get one from https://app.blitz-api.ai

````

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