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

# Available company filters for prospecting searches

> Retrieve valid filter values for industries, sizes, revenues, locations, SIC codes, NAICS codes, intent topics, and technologies for company search.

Use these filter endpoints to retrieve the exact values the API accepts before building a company search request. Passing values outside the API's taxonomy causes searches to return no results, so fetching valid options first ensures your queries work as expected.

All filter values returned here are intended for use in `POST /prospecting/company/search`.

## Available filter endpoints

| Filter        | Endpoint                                           | Method             |
| ------------- | -------------------------------------------------- | ------------------ |
| Company names | `/prospecting/filters/companies/names`             | POST (text search) |
| Industries    | `/prospecting/filters/companies/industries_labels` | GET                |
| Sizes         | `/prospecting/filters/companies/sizes`             | GET                |
| Revenues      | `/prospecting/filters/companies/revenues`          | GET                |
| Locations     | `/prospecting/filters/companies/locations`         | POST (text search) |
| SIC codes     | `/prospecting/filters/companies/sics`              | GET                |
| NAICS codes   | `/prospecting/filters/companies/naics`             | GET                |
| Intent topics | `/prospecting/filters/companies/intent_topics`     | GET                |
| Technologies  | `/prospecting/filters/companies/technologies`      | POST (text search) |

## How to use these endpoints

<Steps>
  <Step title="Fetch valid filter values">
    Call the filter endpoint for the dimension you want to filter on. For example, to get the list of industries:

    ```bash theme={null}
    curl --request GET \
      --url https://api.lusha.com/prospecting/filters/companies/industries_labels \
      --header 'api_key: YOUR_API_KEY'
    ```

    The response is a bare array of industry objects, each with a `main_industry` label, a `main_industry_id`, and a list of `sub_industries`:

    ```json theme={null}
    [
      {
        "main_industry": "Hospitality",
        "main_industry_id": 1,
        "sub_industries": [{ "value": "Other", "id": 778 }]
      }
    ]
    ```
  </Step>

  <Step title="Pick the values that match your ICP">
    Industries are filtered by numeric ID, not by label string. Note the `main_industry_id` (and any `sub_industries[].id`) that apply to your target market.
  </Step>

  <Step title="Pass them into your company search request">
    Nest the selected values under `filters.companies.include` in `POST /prospecting/company/search`:

    ```json theme={null}
    {
      "filters": {
        "companies": {
          "include": {
            "mainIndustriesIds": [1],
            "subIndustriesIds": [778],
            "sizes": [{ "min": 51, "max": 200 }],
            "revenues": [{ "min": 10000001, "max": 50000000 }]
          }
        }
      }
    }
    ```
  </Step>
</Steps>

## Text-search endpoints

Three filter endpoints use `POST` with a text query to search for matching values rather than returning a fixed list.

<CodeGroup>
  ```bash company names theme={null}
  curl --request POST \
    --url https://api.lusha.com/prospecting/filters/companies/names \
    --header 'api_key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{ "text": "Salesforce" }'
  ```

  ```bash locations theme={null}
  curl --request POST \
    --url https://api.lusha.com/prospecting/filters/companies/locations \
    --header 'api_key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{ "text": "Austin" }'
  ```

  ```bash technologies theme={null}
  curl --request POST \
    --url https://api.lusha.com/prospecting/filters/companies/technologies \
    --header 'api_key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{ "text": "Salesforce" }'
  ```
</CodeGroup>

## Endpoint details

### GET /prospecting/filters/companies/industries\_labels

Returns the full industry hierarchy, with each main industry's `main_industry_id` and its `sub_industries` IDs, for filtering by numeric ID.

```bash theme={null}
curl --request GET \
  --url https://api.lusha.com/prospecting/filters/companies/industries_labels \
  --header 'api_key: YOUR_API_KEY'
```

### GET /prospecting/filters/companies/sizes

Returns available employee headcount ranges as `{min, max}` objects (e.g., `{"min": 1, "max": 10}`, `{"min": 11, "max": 50}`).

```bash theme={null}
curl --request GET \
  --url https://api.lusha.com/prospecting/filters/companies/sizes \
  --header 'api_key: YOUR_API_KEY'
```

### GET /prospecting/filters/companies/revenues

Returns available annual revenue ranges as `{min, max}` objects, in raw USD (e.g., `{"min": 1, "max": 1000000}`).

```bash theme={null}
curl --request GET \
  --url https://api.lusha.com/prospecting/filters/companies/revenues \
  --header 'api_key: YOUR_API_KEY'
```

### GET /prospecting/filters/companies/sics

Returns available Standard Industrial Classification (SIC) codes for industry-based filtering.

```bash theme={null}
curl --request GET \
  --url https://api.lusha.com/prospecting/filters/companies/sics \
  --header 'api_key: YOUR_API_KEY'
```

### GET /prospecting/filters/companies/naics

Returns available North American Industry Classification System (NAICS) codes.

```bash theme={null}
curl --request GET \
  --url https://api.lusha.com/prospecting/filters/companies/naics \
  --header 'api_key: YOUR_API_KEY'
```

### GET /prospecting/filters/companies/intent\_topics

Returns intent topic labels you can use to target companies actively researching specific subjects.

```bash theme={null}
curl --request GET \
  --url https://api.lusha.com/prospecting/filters/companies/intent_topics \
  --header 'api_key: YOUR_API_KEY'
```

<Tip>
  Cache responses from the GET endpoints - industries, sizes, revenues, SIC codes, NAICS codes, and intent topics change infrequently. Refresh your cache weekly or when a search returns unexpected results.
</Tip>

<Note>
  SIC and NAICS codes provide more granular industry targeting than industry labels. Use them when you need to narrow your search to a specific sub-sector that does not map cleanly to a label.
</Note>