Get the accepted company-search filter values
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/companies/filter-options \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/companies/filter-options"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.tryfuse.ai/api/v1/business/companies/filter-options', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"filterOptions": {
"fiberIndustries": [
"Administrative Services",
"Aerospace & Military",
"Artificial Intelligence",
"Finance",
"Software",
"Travel & Tourism"
],
"crunchbaseIndustries": [
"3D Printing",
"3D Technology",
"A/B Testing",
"Financial Services"
],
"crunchbaseCategoryGroups": [
"Administrative Services",
"Advertising",
"Agriculture and Farming",
"Apps",
"Financial Services"
],
"linkedinIndustries": [
"3D Printing",
"Abrasives and Nonmetallic Minerals Manufacturing",
"Software Development"
],
"companyTags": [
"raised-from-top-vc",
"is-government",
"is-school",
"venture-backed-startup"
],
"fundingStages": [
"pre_seed",
"seed",
"series_a",
"series_b",
"public",
"acquired",
"closed",
"private_equity",
"unknown"
],
"statuses": [
"active",
"acquired",
"closed"
],
"fortuneRankings": [
"fortune-500",
"fortune-1000",
"forbes-global-2000"
],
"naicsCodes": [
{
"code": "11",
"title": "Agriculture, Forestry, Fishing and Hunting"
},
{
"code": "111110",
"title": "Soybean Farming"
},
{
"code": "513210",
"title": "Software Publishers"
}
],
"countries": [
{
"name": "United States of America",
"apiCode": "USA",
"isoCodeAlpha2": "US",
"flag": "🇺🇸"
},
{
"name": "United Kingdom",
"apiCode": "GBR",
"isoCodeAlpha2": "GB",
"flag": "🇬🇧"
}
],
"accelerators": [
{
"acceleratorSlug": "ycombinator",
"acceleratorName": "Y Combinator",
"numCompanies": 6219
},
{
"acceleratorSlug": "techstars",
"acceleratorName": "Techstars",
"numCompanies": 5612
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Company search
Get the accepted company-search filter values
Get the valid values for one company-search filter (industry, funding stage, country, NAICS code, tag, accelerator) or for all of them. Free. Send field with the name a filter is sent under, e.g. industriesV2: the answer is filterOptions.fields.<field>, shaped like GET /prospects/filter-options (valueShape is include_exclude, term, range or date_range; include/exclude entries take the value and label given; autocomplete names the GET /companies/autocomplete query for headquartersCity and investors). Without field, the lists below come back as before. The accepted values for every enum-backed company filter, each list trimmed to exactly what a filter takes. Use fiberIndustries for industriesV2, linkedinIndustries for linkedinIndustries, crunchbaseIndustries for crunchbaseCategories, crunchbaseCategoryGroups for crunchbaseCategoryGroups (case-sensitive — copy them verbatim), companyTags for tags, naicsCodes[].code for naicsCodes, countries[].apiCode for both headquartersCountryCode and officeLocationsV2, accelerators[].acceleratorSlug for acceleratorsV2, fundingStages for stage, statuses for status and fortuneRankings for fortuneRankings. Only technologies has no served vocabulary and is documented on the request schema instead; company names, investor domains and headquartersCity place names come from GET /companies/autocomplete. Static vocabulary: no tenant data and no credits.
Errors:
429RATE_LIMITED— Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.500UNEXPECTED_ERROR— The request failed inside the service; nothing was billed and the request_id identifies the failure.
Requires one of the following token scopes: companies.
GET
/
business
/
companies
/
filter-options
Get the accepted company-search filter values
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/companies/filter-options \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/companies/filter-options"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.tryfuse.ai/api/v1/business/companies/filter-options', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"filterOptions": {
"fiberIndustries": [
"Administrative Services",
"Aerospace & Military",
"Artificial Intelligence",
"Finance",
"Software",
"Travel & Tourism"
],
"crunchbaseIndustries": [
"3D Printing",
"3D Technology",
"A/B Testing",
"Financial Services"
],
"crunchbaseCategoryGroups": [
"Administrative Services",
"Advertising",
"Agriculture and Farming",
"Apps",
"Financial Services"
],
"linkedinIndustries": [
"3D Printing",
"Abrasives and Nonmetallic Minerals Manufacturing",
"Software Development"
],
"companyTags": [
"raised-from-top-vc",
"is-government",
"is-school",
"venture-backed-startup"
],
"fundingStages": [
"pre_seed",
"seed",
"series_a",
"series_b",
"public",
"acquired",
"closed",
"private_equity",
"unknown"
],
"statuses": [
"active",
"acquired",
"closed"
],
"fortuneRankings": [
"fortune-500",
"fortune-1000",
"forbes-global-2000"
],
"naicsCodes": [
{
"code": "11",
"title": "Agriculture, Forestry, Fishing and Hunting"
},
{
"code": "111110",
"title": "Soybean Farming"
},
{
"code": "513210",
"title": "Software Publishers"
}
],
"countries": [
{
"name": "United States of America",
"apiCode": "USA",
"isoCodeAlpha2": "US",
"flag": "🇺🇸"
},
{
"name": "United Kingdom",
"apiCode": "GBR",
"isoCodeAlpha2": "GB",
"flag": "🇬🇧"
}
],
"accelerators": [
{
"acceleratorSlug": "ycombinator",
"acceleratorName": "Y Combinator",
"numCompanies": 6219
},
{
"acceleratorSlug": "techstars",
"acceleratorName": "Techstars",
"numCompanies": 5612
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Authorizations
Your API token (af_…) as the Basic-auth username, with an empty password.
Query Parameters
One filter to answer for, by the name it is sent under in filters (e.g. industriesV2); omitted, every list is answered as before.
Available options:
nameLike, domains, keywords, status, tags, industriesV2, linkedinIndustries, crunchbaseCategories, crunchbaseCategoryGroups, naicsCodes, headquartersCountryCode, headquartersStateName, headquartersCity, employeeCountV2, revenueUSD, totalFundingUSD, lastFundingUSD, stage, technologies, investors, foundedOn, lastFundedOn, acceleratorsV2, fortuneRankings, officeLocationsV2, linkedinSlugs Response
Success
Without field: every list below. With field: only fields, holding that one filter.
Show child attributes
Show child attributes