Lusha

Lusha Company Filters API

Available filters for company searches

GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /prospecting/filters/companies/names Look up company names for filtering · Names #
Ask an LLM
“How do I find the exact company name to use in a prospecting filter?”
“Can I search company names by partial text?”
Tell an agent
Look up company names matching {text}.
Find company name filter values for {text}.
GET /prospecting/filters/companies/industries_labels List industries for company filters · Industries #
Ask an LLM
“What industries can I filter companies by?”
“Which industry labels does Lusha prospecting accept?”
Tell an agent
List the available company industries.
Show me every industry label I can filter on.
GET /prospecting/filters/companies/sizes List company size ranges · Sizes #
Ask an LLM
“What employee size ranges can I filter companies by?”
“Which headcount buckets are available for company prospecting?”
Tell an agent
List the available company size ranges.
Show the headcount ranges I can use as a filter.
GET /prospecting/filters/companies/revenues List company revenue ranges · Revenues #
Ask an LLM
“What revenue ranges can I filter companies by?”
“Which annual revenue brackets does prospecting support?”
Tell an agent
List the available company revenue ranges.
Show me the revenue brackets for filtering companies.
POST /prospecting/filters/companies/locations Look up company locations for filtering · Locations #
Ask an LLM
“How do I find a company headquarters location to filter on?”
“Can I search company locations by city or country name?”
Tell an agent
Look up company locations matching {text}.
Find the company location filter value for {text}.
GET /prospecting/filters/companies/sics List SIC codes for company filters · SIC Codes #
Ask an LLM
“Which SIC codes can I filter companies by?”
“Where do I get the list of SIC industry codes for prospecting?”
Tell an agent
List the available SIC codes.
Show me every SIC code I can use in a company filter.
GET /prospecting/filters/companies/naics List NAICS codes for company filters · NAICS Codes #
Ask an LLM
“Which NAICS codes can I filter companies by?”
“Where do I get the NAICS code list for company prospecting?”
Tell an agent
List the available NAICS codes.
Show me every NAICS code I can filter companies on.
GET /prospecting/filters/companies/intent_topics List buyer intent topics · Intent Topics #
Ask an LLM
“What buyer intent topics can I filter companies by?”
“Which intent topics does Lusha track?”
Tell an agent
List the available intent topics.
Show me the buyer intent topics for company filtering.
POST /prospecting/filters/companies/technologies Look up technologies for filtering · Technologies #
Ask an LLM
“How do I find companies' technologies to filter on, like a CRM product?”
“Can I search the technology list by text?”
Tell an agent
Look up technologies matching {text}.
Find the technology filter value for {text}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lusha/refs/heads/main/openapi/lusha-company-filters-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/lusha:lusha-company-filters-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lusha-company-filters-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Lusha API Documentation Company Filters API
  version: ''
  x-logo:
    url: https://www.lusha.com/logo.png
  license:
    name: Proprietary
    url: https://lusha.com/legal/terms
  description: ⚠️ **This version is soon to be deprecated.** Please migrate to V3.
  contact:
    name: Lusha Support
    url: https://api.lusha.com
    email: support@lusha.com
  termsOfService: https://lusha.com/legal/terms
  x-privacy-policy:
    name: Privacy Policy
    url: https://lusha.com/legal/privacy-notice/
servers:
- url: https://api.lusha.com
  description: Production server
security:
- ApiKeyAuth: []
tags:
- name: Company Filters
  description: Available filters for company searches
  x-parent-tag: Prospecting
paths:
  /prospecting/filters/companies/names:
    post:
      tags:
      - Company Filters
      summary: Names
      description: Search for company names by text
      operationId: searchCompanyNames
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyNameSearchRequest'
            example:
              text: lusha
      responses:
        '200':
          description: Matching companies
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompanyNameResult'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/companies/industries_labels:
    get:
      tags:
      - Company Filters
      summary: Industries
      description: Get list of available industries for company filtering
      operationId: getCompanyIndustries
      responses:
        '200':
          description: Industry hierarchy
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IndustryLabel'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/companies/sizes:
    get:
      tags:
      - Company Filters
      summary: Sizes
      description: Get list of available company size ranges
      operationId: getCompanySizes
      responses:
        '200':
          description: Company size ranges
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompanySizeRange'
              example:
              - min: 1
                max: 10
              - min: 11
                max: 50
              - min: 51
                max: 200
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/companies/revenues:
    get:
      tags:
      - Company Filters
      summary: Revenues
      description: Get list of available revenue ranges
      operationId: getCompanyRevenues
      responses:
        '200':
          description: Revenue ranges
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RevenueRange'
              example:
              - min: 1
                max: 1000000
              - min: 1000001
                max: 10000000
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/companies/locations:
    post:
      tags:
      - Company Filters
      summary: Locations
      description: Search for company locations by text
      operationId: searchCompanyLocations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LocationSearchRequest'
            example:
              text: Israel
      responses:
        '200':
          description: Matching locations
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompanyLocationFilter'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/companies/sics:
    get:
      tags:
      - Company Filters
      summary: SIC Codes
      description: Get list of available SIC codes
      operationId: getCompanySicCodes
      responses:
        '200':
          description: SIC codes
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SicCode'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/companies/naics:
    get:
      tags:
      - Company Filters
      summary: NAICS Codes
      description: Get list of available NAICS codes
      operationId: getCompanyNaicsCodes
      responses:
        '200':
          description: NAICS codes
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NaicsCode'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/companies/intent_topics:
    get:
      tags:
      - Company Filters
      summary: Intent Topics
      description: Get list of available intent topics
      operationId: getCompanyIntentTopics
      responses:
        '200':
          description: Intent topics
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
              example:
              - Android
              - Accounting
              - Zero Trust
              - Digital Sales
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/companies/technologies:
    post:
      tags:
      - Company Filters
      summary: Technologies
      description: Search for technologies by text
      operationId: searchCompanyTechnologies
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TechnologySearchRequest'
            example:
              text: rss
      responses:
        '200':
          description: Matching technologies
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Technology'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ErrorResponse:
      type: object
      required:
      - statusCode
      - message
      properties:
        statusCode:
          type: integer
          description: HTTP status code
          example: 400
        message:
          type: string
          description: Error message
          example: Validation failed
        errors:
          type: array
          items:
            type: string
          description: Detailed error messages (optional, only for validation errors)
          example:
          - 'entityType must be one of: contact, company'
    RevenueRange:
      type: object
      properties:
        min:
          type: number
          example: 1
        max:
          type: number
          example: 1000000
    LocationSearchRequest:
      type: object
      properties:
        text:
          type: string
          description: Search text for location
          example: un
      required:
      - text
    CompanyNameResult:
      type: object
      properties:
        companyId:
          type: number
          example: 33222678
        name:
          type: string
          example: Lusha
        logoUrl:
          type: string
          example: https://logo.lusha.co/d/company_33222678_logo.jpg
        fqdn:
          type: string
          example: www.lusha.com
    NaicsCode:
      type: object
      properties:
        code:
          type: string
          example: '11'
        label:
          type: string
          example: Agriculture, Forestry, Fishing and Hunting
    TechnologySearchRequest:
      type: object
      properties:
        text:
          type: string
          description: Search text for technology
          example: rss
      required:
      - text
    CompanySizeRange:
      type: object
      properties:
        min:
          type: number
          example: 1
        max:
          type: number
          example: 10
    Technology:
      type: object
      properties:
        name:
          type: string
          example: rss
    IndustryLabel:
      type: object
      properties:
        main_industry:
          type: string
          example: Hospitality
        main_industry_id:
          type: number
          example: 1
        sub_industries:
          type: array
          items:
            type: object
            properties:
              value:
                type: string
                example: Other
              id:
                type: number
                example: 778
    CompanyLocationFilter:
      type: object
      properties:
        country:
          type: string
          example: United States
        continent:
          type: string
          example: North America
        country_grouping:
          type: string
          example: na
    CompanyNameSearchRequest:
      type: object
      properties:
        text:
          type: string
          description: Search text for company name
          example: lusha
      required:
      - text
    SicCode:
      type: object
      properties:
        code:
          type: string
          example: '1011'
        label:
          type: string
          example: Iron ores
  responses:
    Unauthorized:
      description: Unauthorized - invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            statusCode: 401
            message: Invalid API key
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: 'Your Lusha API key. You can find this in your Lusha dashboard under API settings.


        Include this key in the `api_key` header for all requests.

        '