cURL
curl --request GET \
--url 'https://api.airscale.io/v1/find-companies/filter-values?filter=industry&q=example' \
--header "Authorization: Bearer $AIRSCALE_API_KEY"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);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()){
"filter": "industry",
"query": "example",
"values": [
{
"label": "Example industry",
"value": "example industry"
}
]
}
Company filter values
Search supported values for Find Companies filters. Rate limit: 6 requests per second per workspace.
GET
/
v1
/
find-companies
/
filter-values
cURL
curl --request GET \
--url 'https://api.airscale.io/v1/find-companies/filter-values?filter=industry&q=example' \
--header "Authorization: Bearer $AIRSCALE_API_KEY"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);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()){
"filter": "industry",
"query": "example",
"values": [
{
"label": "Example industry",
"value": "example industry"
}
]
}
Discover accepted values before adding a city, region, industry, topic, or technology filter to Find companies.
Each result has a display
Filter-values is free and has no request body. It does not reserve or debit Airschool credits.
Choose useful context
Usecountry 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. SetAIRSCALE_API_KEY in your server environment before running a command.
Region suggestions
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'
City suggestions
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'
Technology suggestions
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'
Industry suggestions
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'
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 returnedvalue into the matching filter on Find companies.Authorizations
Use an Airschool workspace API key. Never expose the key in client-side code.
Query Parameters
The Find Companies filter whose accepted values should be discovered.
Available options:
city, region, industry, topics, techStack 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.
Pattern:
^\s*\S[\s\S]{0,118}\S\s*$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.
Pattern:
^\s*\S[\s\S]{0,118}\S\s*$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.
Example:
20
Optional country context supplied as repeat or comma-separated values.
Optional region context supplied as repeat or comma-separated values; a bare region name needs country context.