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 Airscale 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'
Business intent topic suggestions
curl --get 'https://api.airscale.io/v1/find-companies/filter-values' \
-H "Authorization: Bearer $AIRSCALE_API_KEY" \
--data-urlencode 'filter=topics' \
--data-urlencode 'q=customer relationship'
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, or into topics on Business intent topics.Authorizations
Use an Airscale 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.