curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/companies/search \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.tryfuse.ai/api/v1/business/companies/search"
payload = {}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.tryfuse.ai/api/v1/business/companies/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"companies": [
{
"preferred_name": "Airbnb",
"names": [
"AirBed & Breakfast",
"Airbnb, Inc.",
"Airbnb",
"Airbnb Inc"
],
"domains": [
"airbnb.com",
"abnb.me",
"airbnb.ca",
"airbnb.co.in",
"airbnb.com.br",
"airbnb.co.uk",
"airbnb.fr",
"airbnb.it",
"airbnb.nl"
],
"websites": [
"airbnb.com"
],
"linkedin_primary_slug": "airbnb",
"linkedin_slugs": [
"airbnb"
],
"linkedin_id": "309694",
"li_description": "Airbnb was born in 2007 when two hosts welcomed three guests to their San Francisco home, and has since grown to over 5 million hosts who have welcomed over 2 billion guest arrivals in almost every country across the globe. Every day, hosts offer unique stays, experiences and services that make it possible for guests to connect with communities in a more authentic way.",
"li_follower_count": 3115489,
"li_industries": [
{
"id": "4",
"name": "Software Development"
}
],
"standard_industries": [
"Retail",
"Real Estate",
"Hospitality",
"Software",
"Travel & Tourism"
],
"naics_codes": [
"513210",
"721110"
],
"tags": [
"raised-from-top-vc"
],
"status_consensus": "active",
"funding_stage": "public",
"founded_on_consensus": "2008-08-11T00:00:00.000Z",
"employee_count_consensus": {
"gte": 72716,
"lte": 72716
},
"revenue_estimate": {
"sources": [
"https://bullfincher.io/companies/airbnb/revenue",
"https://www.macrotrends.net/stocks/charts/ABNB/airbnb/revenue",
"https://stockanalysis.com/quote/bvl/ABNB/revenue/",
"https://sqmagazine.co.uk/airbnb-statistics/",
"http://www.wallstreetzen.com/stocks/us/nasdaq/abnb/revenue",
"https://www.statista.com/topics/2273/airbnb/",
"https://stockanalysis.com/stocks/abnb/revenue/",
"https://news.airbnb.com/airbnb-q4-2025-financial-results/",
"https://www.sec.gov/Archives/edgar/data/1559720/000119312526048670/d58192dex991.htm"
],
"fiscal_year": 2025,
"value_usd": {
"gte": 12241000000,
"lte": 12241000000
}
},
"total_funding_consensus": 8935132065,
"location_consensus": {
"street_address": "888 Brannan Street",
"neighborhood": null,
"city": "San Francisco",
"state_name": "California",
"state_code": "CA",
"county": null,
"postal_code": "94103",
"country_code": "USA",
"country_name": "United States of America",
"coordinates": {
"lat": 37.779238,
"lon": -122.419359
},
"timezone": null,
"full_address": "San Francisco, California, United States of America",
"formatted_address": "San Francisco, California, United States of America"
},
"location_name": "San Francisco, California, United States of America",
"logo_url": "https://api.fiber.ai/v1/company-logo/at_bomkrvppqn1pssoqsxqy.jpeg",
"short_description": "Airbnb is an online community marketplace for people to list, discover, and book accommodations through mobile phones or the Internet.",
"technologies_used": [
{
"name": "slack"
}
],
"is_investor": true,
"relevance_score": 12.987053,
"isSaved": true
}
],
"total": 438741,
"nextCursor": "gAAAAABqjeNDAAd1qTVJYeUYtzhveDm-GOvYXgomDWX2a6V4OvEFB44biu_7SGszYsdcHjezHmxytwVmoiTf4P5VcPuiv4nFQQuCs4ZvsJu17hJ2n1tiR_w=",
"filters": {
"status": [
{
"label": "Active",
"value": "active",
"status": "include"
}
],
"industriesV2": [
{
"label": "Travel & Tourism",
"value": "Travel & Tourism",
"status": "include"
},
{
"label": "Artificial Intelligence",
"value": "Artificial Intelligence",
"status": "exclude"
}
]
}
}{
"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>"
}
}Run a company search
The company twin of the people search. The filter source is exactly one of: literal filters, a stored COMPANY saved search (savedSearchId / savedSearchName), or a natural-language query (converted into filters server-side; criteria it could not map come back as unresolvedCriteria). A people saved search answers 422 SAVED_SEARCH_TYPE_MISMATCH.
The response always echoes the RESOLVED filters. Page by re-sending the same filter source together with the returned nextCursor as cursor; nextCursor is null on the last page. total is the true match count and is only counted on the FIRST page — every cursor page answers total: null, so read the count once and carry it.
Rows are the provider’s company record (snake_case, ~80 fields, varying by company: names, domains, LinkedIn metadata, industries, NAICS codes, headcount and revenue estimates, funding, technologies, headquarters location) plus Fuse’s isSaved, which says whether the company is already in one of your company lists.
filters.headquartersCity names are geocoded one by one and the resulting city areas are OR-ed together; a name that geocodes to nothing is dropped and the search runs on the rest, so take the values from GET /companies/autocomplete?field=location. Only when not one name resolves is the search refused with 422 CITY_FILTER_UNRESOLVED. employeeCountV2 is the one range whose lower bound is exclusive: { min: 50 } matches companies with more than 50 employees.
Billing: 2 credits per requested company are pre-checked and 2 credits per company returned are debited.
Errors:
402INSUFFICIENT_CREDITS— The balance does not cover the pre-check for this request; nothing was billed.404SAVED_SEARCH_NOT_FOUND— No saved search of yours has that id or exact title.409SAVED_SEARCH_NAME_AMBIGUOUS— Two of your saved searches share that title — reference it bysavedSearchIdinstead.422VALIDATION_FAILED— The request failed the declared schema;paramnames the offending key andmessagequotes the rule it broke.422SAVED_SEARCH_TYPE_MISMATCH— The saved search exists but stores the other kind of filters;paramissavedSearchId.422SAVED_SEARCH_INVALID— The STORED filters no longer form a runnable company search — the blob is empty, or every value in it was retired. A filterless stored search is refused here rather than run as a whole-universe search.422QUERY_FILTERS_INVALID— The natural-languagequeryproduced no usable filter; name concrete criteria.422CITY_FILTER_UNRESOLVED— NOT ONE of thefilters.headquartersCitynames geocoded to a city area, so the search was refused rather than run worldwide; names that do geocode are OR-ed together and a name that does not is dropped, so this fires only when every name fails.paramisfilters.headquartersCity.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.
curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/companies/search \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.tryfuse.ai/api/v1/business/companies/search"
payload = {}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.tryfuse.ai/api/v1/business/companies/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"companies": [
{
"preferred_name": "Airbnb",
"names": [
"AirBed & Breakfast",
"Airbnb, Inc.",
"Airbnb",
"Airbnb Inc"
],
"domains": [
"airbnb.com",
"abnb.me",
"airbnb.ca",
"airbnb.co.in",
"airbnb.com.br",
"airbnb.co.uk",
"airbnb.fr",
"airbnb.it",
"airbnb.nl"
],
"websites": [
"airbnb.com"
],
"linkedin_primary_slug": "airbnb",
"linkedin_slugs": [
"airbnb"
],
"linkedin_id": "309694",
"li_description": "Airbnb was born in 2007 when two hosts welcomed three guests to their San Francisco home, and has since grown to over 5 million hosts who have welcomed over 2 billion guest arrivals in almost every country across the globe. Every day, hosts offer unique stays, experiences and services that make it possible for guests to connect with communities in a more authentic way.",
"li_follower_count": 3115489,
"li_industries": [
{
"id": "4",
"name": "Software Development"
}
],
"standard_industries": [
"Retail",
"Real Estate",
"Hospitality",
"Software",
"Travel & Tourism"
],
"naics_codes": [
"513210",
"721110"
],
"tags": [
"raised-from-top-vc"
],
"status_consensus": "active",
"funding_stage": "public",
"founded_on_consensus": "2008-08-11T00:00:00.000Z",
"employee_count_consensus": {
"gte": 72716,
"lte": 72716
},
"revenue_estimate": {
"sources": [
"https://bullfincher.io/companies/airbnb/revenue",
"https://www.macrotrends.net/stocks/charts/ABNB/airbnb/revenue",
"https://stockanalysis.com/quote/bvl/ABNB/revenue/",
"https://sqmagazine.co.uk/airbnb-statistics/",
"http://www.wallstreetzen.com/stocks/us/nasdaq/abnb/revenue",
"https://www.statista.com/topics/2273/airbnb/",
"https://stockanalysis.com/stocks/abnb/revenue/",
"https://news.airbnb.com/airbnb-q4-2025-financial-results/",
"https://www.sec.gov/Archives/edgar/data/1559720/000119312526048670/d58192dex991.htm"
],
"fiscal_year": 2025,
"value_usd": {
"gte": 12241000000,
"lte": 12241000000
}
},
"total_funding_consensus": 8935132065,
"location_consensus": {
"street_address": "888 Brannan Street",
"neighborhood": null,
"city": "San Francisco",
"state_name": "California",
"state_code": "CA",
"county": null,
"postal_code": "94103",
"country_code": "USA",
"country_name": "United States of America",
"coordinates": {
"lat": 37.779238,
"lon": -122.419359
},
"timezone": null,
"full_address": "San Francisco, California, United States of America",
"formatted_address": "San Francisco, California, United States of America"
},
"location_name": "San Francisco, California, United States of America",
"logo_url": "https://api.fiber.ai/v1/company-logo/at_bomkrvppqn1pssoqsxqy.jpeg",
"short_description": "Airbnb is an online community marketplace for people to list, discover, and book accommodations through mobile phones or the Internet.",
"technologies_used": [
{
"name": "slack"
}
],
"is_investor": true,
"relevance_score": 12.987053,
"isSaved": true
}
],
"total": 438741,
"nextCursor": "gAAAAABqjeNDAAd1qTVJYeUYtzhveDm-GOvYXgomDWX2a6V4OvEFB44biu_7SGszYsdcHjezHmxytwVmoiTf4P5VcPuiv4nFQQuCs4ZvsJu17hJ2n1tiR_w=",
"filters": {
"status": [
{
"label": "Active",
"value": "active",
"status": "include"
}
],
"industriesV2": [
{
"label": "Travel & Tourism",
"value": "Travel & Tourism",
"status": "include"
},
{
"label": "Artificial Intelligence",
"value": "Artificial Intelligence",
"status": "exclude"
}
]
}
}{
"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.
Body
Exactly one filter source — filters, savedSearchId, savedSearchName or query — plus optional paging.
Literal filters, one of the four filter sources. Company filters in the search vocabulary: include/exclude fields take [{ status, value, label }] entries (label is required), list fields arrays of strings, ranges { min, max } and date ranges { start, end } — enum vocabularies come from GET /companies/filter-options, names and places from GET /companies/autocomplete. Must contain at least one non-empty value.
Show child attributes
Show child attributes
Id of one of your COMPANY saved searches to take the filters from instead of filters (a people saved search answers 422 SAVED_SEARCH_TYPE_MISMATCH).
Exact title of one of your company saved searches to take the filters from instead of filters; two searches sharing the title answer 409 SAVED_SEARCH_NAME_AMBIGUOUS.
1 - 255Natural-language description of the companies to find (max 2000 chars), converted into filters server-side instead of filters; criteria that could not be mapped come back as unresolvedCriteria, and a query yielding no filter answers 422 QUERY_FILTERS_INVALID.
1 - 2000Companies per page (1-100, default 25); the search pre-checks 2 credits per requested company and debits 2 credits per company returned.
1 <= x <= 100The nextCursor returned by the previous page, sent together with the same filter source; null (default) starts from the first page. The match total is only counted on the first page — it comes back null on every cursor page.
Response
Success
Show child attributes
Show child attributes
True match count on the first page; null on every cursor page, where the upstream does not count.
Send back as cursor with the same filter source for the next page; null on the last page.
The RESOLVED filters the search actually ran.
Only when the source was query: criteria in the prose that could not be turned into a filter.