> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airscale.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Company filter values
> Search supported values for Find Companies filters. Rate limit: 6 requests per second per workspace.
Discover accepted values before adding a city, region, industry, topic, or technology filter to [Find companies](/api-reference/find-companies).
Filter-values is free and has no request body. It does not reserve or debit Airschool credits.
## Choose useful context
Use `country` and `region` to narrow location suggestions. A bare region name needs country context. The `q` parameter takes precedence when both `q` and its `query` alias are present; a blank `q` still suppresses `query` and returns `400 Bad Request`.
The operation shares a limit of 6 requests per second per workspace with Find companies. After a `429 Too Many Requests` response, wait for the next second and retry with bounded exponential backoff.
This page renders non-executing examples. It does not send a request or ask for an API key.
## Discovery examples
These examples only discover filter values; the endpoint is free. Set `AIRSCALE_API_KEY` in your server environment before running a command.
```bash Region suggestions theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --get 'https://api.airscale.io/v1/find-companies/filter-values' \
-H "Authorization: Bearer $AIRSCALE_API_KEY" \
--data-urlencode 'filter=region' \
--data-urlencode 'q=california' \
--data-urlencode 'country=US'
```
```bash City suggestions theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --get 'https://api.airscale.io/v1/find-companies/filter-values' \
-H "Authorization: Bearer $AIRSCALE_API_KEY" \
--data-urlencode 'filter=city' \
--data-urlencode 'q=san' \
--data-urlencode 'country=US' \
--data-urlencode 'region=us-ca'
```
```bash Technology suggestions theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --get 'https://api.airscale.io/v1/find-companies/filter-values' \
-H "Authorization: Bearer $AIRSCALE_API_KEY" \
--data-urlencode 'filter=techStack' \
--data-urlencode 'q=hubspot'
```
```bash Industry suggestions theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --get 'https://api.airscale.io/v1/find-companies/filter-values' \
-H "Authorization: Bearer $AIRSCALE_API_KEY" \
--data-urlencode 'filter=industry' \
--data-urlencode 'q=software'
```
Each result has a display `label` and a request `value`. Copy `value` into the corresponding search filter. For locations, preserve the returned country/region context instead of assembling a city value from its display label. Search accepts recognized pipe-form and comma-form city values; autocomplete supplies the value to reuse.
`q` or its `query` alias must contain 2–120 characters after trimming. `q` takes precedence even when blank. The optional `limit` defaults to 20; integer values are clamped to 1–100, while non-numeric or non-integer values use the default.
## Next step
Copy the returned `value` into the matching filter on [Find companies](/api-reference/find-companies).
## OpenAPI
````yaml openapi.json GET /v1/find-companies/filter-values
openapi: 3.1.0
info:
title: Airschool Public API
version: '2026-09-11'
description: Search, enrich, and resolve public business data with Airschool.
x-airscale-source-repository: ViceScale/airscale-code
x-airscale-source-sha: 1de19e1b70a052a4b8d9c2075021a7e5e7a94d51
servers:
- url: https://api.airscale.io
description: Production
security:
- bearerAuth: []
tags:
- name: Search and discovery
description: Search people, companies, and the web.
- name: Contact data
description: Find professional and personal contact data.
- name: Profiles and reverse lookup
description: Extract profiles or resolve a person from known contact data.
- name: Post engagement
description: Retrieve and enrich people who liked or commented on LinkedIn posts.
- name: Account
description: Inspect workspace account state.
- name: Miscellaneous
description: Check WhatsApp availability, Meta ads, and email deliverability.
paths:
/v1/find-companies/filter-values:
get:
tags:
- Search and discovery
summary: List Find Companies filter values
description: >-
Discovers normalized values accepted by location, industry,
intent-topic, and technology filters.
operationId: listFindCompanyFilterValues
parameters:
- name: filter
in: query
required: true
description: >-
The Find Companies filter whose accepted values should be
discovered.
schema:
type: string
enum:
- city
- region
- industry
- topics
- techStack
- name: q
in: query
required: false
description: >-
At least one of q or query is required and must contain 2 to 120
characters after trimming. When q is present it is read first; a
blank q suppresses query and returns 400.
schema:
type: string
pattern: ^\s*\S[\s\S]{0,118}\S\s*$
- name: query
in: query
required: false
description: >-
At least one of q or query is required and must contain 2 to 120
characters after trimming. query is used only when q is absent.
schema:
type: string
pattern: ^\s*\S[\s\S]{0,118}\S\s*$
- name: limit
in: query
required: false
description: >-
Omitted, non-numeric, or non-integer values default to 20; an
explicit empty value becomes 0 then clamps to 1; integers below 1
clamp to 1; integers above 100 clamp to 100.
schema:
oneOf:
- type: integer
- type: string
default: 20
example: 20
- name: country
in: query
required: false
description: >-
Optional country context supplied as repeat or comma-separated
values.
style: form
explode: true
schema:
oneOf:
- type: string
- type: array
items:
type: string
- name: region
in: query
required: false
description: >-
Optional region context supplied as repeat or comma-separated
values; a bare region name needs country context.
style: form
explode: true
schema:
oneOf:
- type: string
- type: array
items:
type: string
responses:
'200':
description: >-
Normalized filter values matching the query and optional location
context.
content:
application/json:
schema:
type: object
required:
- filter
- query
- values
additionalProperties: false
properties:
filter:
type: string
enum:
- city
- region
- industry
- topics
- techStack
query:
type: string
values:
type: array
items:
type: object
required:
- label
- value
additionalProperties: false
properties:
label:
type: string
value:
type: string
query:
type: string
city:
type: string
region:
type: string
countryCode:
type: string
regionCode:
type: string
examples:
industry:
summary: Synthetic industry values
value:
filter: industry
query: example
values:
- label: Example industry
value: example industry
city:
summary: Synthetic city values
value:
filter: city
query: exa
values:
- query: exa
label: Example City
value: Example City, EX, XX
city: Example City
region: EX
countryCode: xx
regionCode: xx-ex
'400':
description: The request is invalid or contains an unsupported field or value.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
description: >-
The workspace cannot complete this request because access or
available credits are insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: The JSON request body exceeds the 256 KiB limit.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: >-
The workspace rate limit has been exceeded. Try again after the
current window resets.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: >-
The request could not be completed because of an unexpected server
error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: >-
The request could not be completed because a required service
returned an unsuccessful response.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: The request is temporarily unavailable. Try again later.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
x-codeSamples:
- label: cURL
lang: bash
source: |-
curl --request GET \
--url 'https://api.airscale.io/v1/find-companies/filter-values?filter=industry&q=example' \
--header "Authorization: Bearer $AIRSCALE_API_KEY"
- label: Node.js
lang: node
source: >-
const url = new
URL("https://api.airscale.io/v1/find-companies/filter-values");
url.searchParams.set("filter", "industry");
url.searchParams.set("q", "example");
const response = await fetch(url, {
headers: {
Authorization: `Bearer ${process.env.AIRSCALE_API_KEY}`
}
});
const data = await response.json();
console.log(data);
- label: Python
lang: python
source: |-
import os
import requests
response = requests.get(
"https://api.airscale.io/v1/find-companies/filter-values",
headers={"Authorization": f'Bearer {os.environ["AIRSCALE_API_KEY"]}'},
params={"filter": "industry", "q": "example"},
timeout=30,
)
response.raise_for_status()
print(response.json())
components:
schemas:
Error:
type: object
additionalProperties: true
properties:
error:
type: string
message:
type: string
responses:
Unauthorized:
description: The Bearer token is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API key
description: >-
Use an Airschool workspace API key. Never expose the key in client-side
code.
````