Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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 sending the returned filters together with the returned nextCursor as cursor (resending a query converts it again, which is slower and can build a different search); 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: 1 credit per requested company is pre-checked and 1 credit per company returned is 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 by savedSearchId instead.
422VALIDATION_FAILED — The request failed the declared schema; param names the offending key and message quotes the rule it broke.
422SAVED_SEARCH_TYPE_MISMATCH — The saved search exists but stores the other kind of filters; param is savedSearchId.
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-language query produced no usable filter; name concrete criteria.
422CITY_FILTER_UNRESOLVED — NOT ONE of the filters.headquartersCity names 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. param is filters.headquartersCity.
422SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; param names the filter (e.g. filters.industriesV2) and values the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; technologies takes the provider’s predefined names as its field description says. Correct the value and search again.
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.
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.
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.
Natural-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.
The 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.
Only when the source was query: criteria in the prose that could not be turned into a filter.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fuse API","colors":{"primary":"#22857C","light":"#34C7BA","dark":"#22857C"},"logo":{"light":"https://mintcdn.com/fuseai/HxYNa2W1WI8CM0N4/logo/light.svg?fit=max\u0026auto=format\u0026n=HxYNa2W1WI8CM0N4\u0026q=85\u0026s=c9afa73057eb802e14743fbb297c60d5","dark":"https://mintcdn.com/fuseai/HxYNa2W1WI8CM0N4/logo/dark.svg?fit=max\u0026auto=format\u0026n=HxYNa2W1WI8CM0N4\u0026q=85\u0026s=1fc8cdcdfa374184a0d0be9a3559e3ae"},"favicon":{"light":"https://mintcdn.com/fuseai/HxYNa2W1WI8CM0N4/favicon/light.svg?fit=max\u0026auto=format\u0026n=HxYNa2W1WI8CM0N4\u0026q=85\u0026s=ac736774fcb3b9a1a851b2993948e5ec","dark":"https://mintcdn.com/fuseai/HxYNa2W1WI8CM0N4/favicon/dark.svg?fit=max\u0026auto=format\u0026n=HxYNa2W1WI8CM0N4\u0026q=85\u0026s=32e317b320fd34552ab3990cd8a717a4"},"api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":true}},"background":{"color":{"light":"#FFFFFF","dark":"#161615"}},"navbar":{"links":[{"href":"mailto:support@fuseai.com","label":"Support"}],"primary":{"type":"button","label":"Open Fuse","href":"https://app.tryfuse.ai"}},"footer":{"socials":{"website":"https://fuseai.com","linkedin":"https://www.linkedin.com/company/fuseaicom"}},"contextual":{"options":["copy","view","claude","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fuseai","hasAudioNarration":false,"actualSubdomain":"fuseai","customDomains":["docs.fuseai.com"],"gitSource":{"type":"github","owner":"kompassai-com","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae37b777a4e4821c08feade","collectionId":"5bacfad1-97dd-4f59-945f-2a160fb2f0c7","liveDeploymentHistoryId":"6ae37b777a4e4821c08feade","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae37b777a4e4821c08feade","clientVersion":"0.0.4039","searchFilterCounts":[{"language":"default","tag":"API Reference","count":157},{"language":"default","tag":"Documentation","count":50},{"language":"default","tag":"Agents","count":27},{"language":"default","tag":"Knowledge hubs","count":18},{"language":"default","tag":"Lists","count":17},{"language":"default","tag":"Campaigns","count":15},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Workflows","count":10},{"language":"default","tag":"Data","count":9},{"language":"default","tag":"Account","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#topbar-cta-button .bg-primary-dark{background-color:rgb(0 0 0)}.dark #topbar-cta-button .bg-primary-dark{background-color:rgb(255 255 255)}.dark #topbar-cta-button .text-white,.dark #topbar-cta-button .text-white\\/90{color:rgb(0 0 0)}"}],"page":{"pagePath":"api-reference/company-search/run-a-company-search","slug":"/api-reference/company-search/run-a-company-search","pageMetadata":{"title":"Run a company search","description":"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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.\n\nThe response always echoes the RESOLVED `filters`. Page by sending the returned `filters` together with the returned `nextCursor` as `cursor` (resending a `query` converts it again, which is slower and can build a different search); `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.\n\nRows 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.\n\n`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.\n\nBilling: 1 credit per requested company is pre-checked and 1 credit per company returned is debited.\n\nErrors:\n- `402` `INSUFFICIENT_CREDITS` — The balance does not cover the pre-check for this request; nothing was billed.\n- `404` `SAVED_SEARCH_NOT_FOUND` — No saved search of yours has that id or exact title.\n- `409` `SAVED_SEARCH_NAME_AMBIGUOUS` — Two of your saved searches share that title — reference it by `savedSearchId` instead.\n- `422` `VALIDATION_FAILED` — The request failed the declared schema; `param` names the offending key and `message` quotes the rule it broke.\n- `422` `SAVED_SEARCH_TYPE_MISMATCH` — The saved search exists but stores the other kind of filters; `param` is `savedSearchId`.\n- `422` `SAVED_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.\n- `422` `QUERY_FILTERS_INVALID` — The natural-language `query` produced no usable filter; name concrete criteria.\n- `422` `CITY_FILTER_UNRESOLVED` — NOT ONE of the `filters.headquartersCity` names 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. `param` is `filters.headquartersCity`.\n- `422` `SEARCH_FILTERS_INVALID` — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; `param` names the filter (e.g. `filters.industriesV2`) and `values` the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; `technologies` takes the provider's predefined names as its field description says. Correct the value and search again.\n- `429` `RATE_LIMITED` — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.\n- `500` `UNEXPECTED_ERROR` — The request failed inside the service; nothing was billed and the request_id identifies the failure.\n\nRequires one of the following token scopes: companies.","deprecated":null,"version":null,"openapi":"/openapi.json post /business/companies/search","href":"/api-reference/company-search/run-a-company-search","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. The company twin of the people search. The filter source is exactly one of: literal \", _jsx(_components.code, {\n children: \"filters\"\n }), \", a stored COMPANY saved search (\", _jsx(_components.code, {\n children: \"savedSearchId\"\n }), \" / \", _jsx(_components.code, {\n children: \"savedSearchName\"\n }), \"), or a natural-language \", _jsx(_components.code, {\n children: \"query\"\n }), \" (converted into filters server-side; criteria it could not map come back as \", _jsx(_components.code, {\n children: \"unresolvedCriteria\"\n }), \"). A people saved search answers 422 SAVED_SEARCH_TYPE_MISMATCH.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The response always echoes the RESOLVED \", _jsx(_components.code, {\n children: \"filters\"\n }), \". Page by sending the returned \", _jsx(_components.code, {\n children: \"filters\"\n }), \" together with the returned \", _jsx(_components.code, {\n children: \"nextCursor\"\n }), \" as \", _jsx(_components.code, {\n children: \"cursor\"\n }), \" (resending a \", _jsx(_components.code, {\n children: \"query\"\n }), \" converts it again, which is slower and can build a different search); \", _jsx(_components.code, {\n children: \"nextCursor\"\n }), \" is null on the last page. \", _jsx(_components.code, {\n children: \"total\"\n }), \" is the true match count and is only counted on the FIRST page — every cursor page answers \", _jsx(_components.code, {\n children: \"total: null\"\n }), \", so read the count once and carry it.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"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 \", _jsx(_components.code, {\n children: \"isSaved\"\n }), \", which says whether the company is already in one of your company lists.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"filters.headquartersCity\"\n }), \" 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. \", _jsx(_components.code, {\n children: \"employeeCountV2\"\n }), \" is the one range whose lower bound is exclusive: \", _jsx(_components.code, {\n children: \"{ min: 50 }\"\n }), \" matches companies with more than 50 employees.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Billing: 1 credit per requested company is pre-checked and 1 credit per company returned is debited.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Errors:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"402\"\n }), \" \", _jsx(_components.code, {\n children: \"INSUFFICIENT_CREDITS\"\n }), \" — The balance does not cover the pre-check for this request; nothing was billed.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"404\"\n }), \" \", _jsx(_components.code, {\n children: \"SAVED_SEARCH_NOT_FOUND\"\n }), \" — No saved search of yours has that id or exact title.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"409\"\n }), \" \", _jsx(_components.code, {\n children: \"SAVED_SEARCH_NAME_AMBIGUOUS\"\n }), \" — Two of your saved searches share that title — reference it by \", _jsx(_components.code, {\n children: \"savedSearchId\"\n }), \" instead.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"422\"\n }), \" \", _jsx(_components.code, {\n children: \"VALIDATION_FAILED\"\n }), \" — The request failed the declared schema; \", _jsx(_components.code, {\n children: \"param\"\n }), \" names the offending key and \", _jsx(_components.code, {\n children: \"message\"\n }), \" quotes the rule it broke.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"422\"\n }), \" \", _jsx(_components.code, {\n children: \"SAVED_SEARCH_TYPE_MISMATCH\"\n }), \" — The saved search exists but stores the other kind of filters; \", _jsx(_components.code, {\n children: \"param\"\n }), \" is \", _jsx(_components.code, {\n children: \"savedSearchId\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"422\"\n }), \" \", _jsx(_components.code, {\n children: \"SAVED_SEARCH_INVALID\"\n }), \" — 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.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"422\"\n }), \" \", _jsx(_components.code, {\n children: \"QUERY_FILTERS_INVALID\"\n }), \" — The natural-language \", _jsx(_components.code, {\n children: \"query\"\n }), \" produced no usable filter; name concrete criteria.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"422\"\n }), \" \", _jsx(_components.code, {\n children: \"CITY_FILTER_UNRESOLVED\"\n }), \" — NOT ONE of the \", _jsx(_components.code, {\n children: \"filters.headquartersCity\"\n }), \" names 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. \", _jsx(_components.code, {\n children: \"param\"\n }), \" is \", _jsx(_components.code, {\n children: \"filters.headquartersCity\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"422\"\n }), \" \", _jsx(_components.code, {\n children: \"SEARCH_FILTERS_INVALID\"\n }), \" — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; \", _jsx(_components.code, {\n children: \"param\"\n }), \" names the filter (e.g. \", _jsx(_components.code, {\n children: \"filters.industriesV2\"\n }), \") and \", _jsx(_components.code, {\n children: \"values\"\n }), \" the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; \", _jsx(_components.code, {\n children: \"technologies\"\n }), \" takes the provider’s predefined names as its field description says. Correct the value and search again.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"429\"\n }), \" \", _jsx(_components.code, {\n children: \"RATE_LIMITED\"\n }), \" — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"500\"\n }), \" \", _jsx(_components.code, {\n children: \"UNEXPECTED_ERROR\"\n }), \" — The request failed inside the service; nothing was billed and the request_id identifies the failure.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Requires one of the following token scopes: companies.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Run a company search","description":"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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.\n\nThe response always echoes the RESOLVED `filters`. Page by sending the returned `filters` together with the returned `nextCursor` as `cursor` (resending a `query` converts it again, which is slower and can build a different search); `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.\n\nRows 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.\n\n`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.\n\nBilling: 1 credit per requested company is pre-checked and 1 credit per company returned is debited.\n\nErrors:\n- `402` `INSUFFICIENT_CREDITS` — The balance does not cover the pre-check for this request; nothing was billed.\n- `404` `SAVED_SEARCH_NOT_FOUND` — No saved search of yours has that id or exact title.\n- `409` `SAVED_SEARCH_NAME_AMBIGUOUS` — Two of your saved searches share that title — reference it by `savedSearchId` instead.\n- `422` `VALIDATION_FAILED` — The request failed the declared schema; `param` names the offending key and `message` quotes the rule it broke.\n- `422` `SAVED_SEARCH_TYPE_MISMATCH` — The saved search exists but stores the other kind of filters; `param` is `savedSearchId`.\n- `422` `SAVED_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.\n- `422` `QUERY_FILTERS_INVALID` — The natural-language `query` produced no usable filter; name concrete criteria.\n- `422` `CITY_FILTER_UNRESOLVED` — NOT ONE of the `filters.headquartersCity` names 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. `param` is `filters.headquartersCity`.\n- `422` `SEARCH_FILTERS_INVALID` — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; `param` names the filter (e.g. `filters.industriesV2`) and `values` the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; `technologies` takes the provider's predefined names as its field description says. Correct the value and search again.\n- `429` `RATE_LIMITED` — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.\n- `500` `UNEXPECTED_ERROR` — The request failed inside the service; nothing was billed and the request_id identifies the failure.\n\nRequires one of the following token scopes: companies.","deprecated":null,"version":null,"openapi":"/openapi.json post /business/companies/search","href":"/api-reference/company-search/run-a-company-search","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"searchCompanies","summary":"Run a company search","tags":["Company search"],"security":["c6e56776-ecfc-4ee8-82be-ed866e43596e"],"responses":{"200":"80f05cec-22b9-4418-859b-0efb9e114a2d","400":"2d02f891-95ed-4550-8bc3-c5c805ddb635","401":"d71c84cd-b587-445e-a7ae-63963c0e00f3","402":"51ec8f6c-278b-42ed-b806-3160aba66b85","403":"1106b191-4153-469c-a62b-8971a60fd1fc","404":"3664c7b5-8d37-4899-b462-27be6d53897b","409":"023aceae-f337-4a5c-b587-0e4b1a83ddc5","422":"4025fab4-720b-4910-b76d-3945cbc2abf3","429":"dd0c413e-1535-4838-b7ff-8694859f5af8","500":"dd27a6eb-fbb2-4df9-924c-0dc243e9307d"},"description":"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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.\n\nThe response always echoes the RESOLVED `filters`. Page by sending the returned `filters` together with the returned `nextCursor` as `cursor` (resending a `query` converts it again, which is slower and can build a different search); `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.\n\nRows 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.\n\n`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.\n\nBilling: 1 credit per requested company is pre-checked and 1 credit per company returned is debited.\n\nErrors:\n- `402` `INSUFFICIENT_CREDITS` — The balance does not cover the pre-check for this request; nothing was billed.\n- `404` `SAVED_SEARCH_NOT_FOUND` — No saved search of yours has that id or exact title.\n- `409` `SAVED_SEARCH_NAME_AMBIGUOUS` — Two of your saved searches share that title — reference it by `savedSearchId` instead.\n- `422` `VALIDATION_FAILED` — The request failed the declared schema; `param` names the offending key and `message` quotes the rule it broke.\n- `422` `SAVED_SEARCH_TYPE_MISMATCH` — The saved search exists but stores the other kind of filters; `param` is `savedSearchId`.\n- `422` `SAVED_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.\n- `422` `QUERY_FILTERS_INVALID` — The natural-language `query` produced no usable filter; name concrete criteria.\n- `422` `CITY_FILTER_UNRESOLVED` — NOT ONE of the `filters.headquartersCity` names 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. `param` is `filters.headquartersCity`.\n- `422` `SEARCH_FILTERS_INVALID` — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; `param` names the filter (e.g. `filters.industriesV2`) and `values` the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; `technologies` takes the provider's predefined names as its field description says. Correct the value and search again.\n- `429` `RATE_LIMITED` — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.\n- `500` `UNEXPECTED_ERROR` — The request failed inside the service; nothing was billed and the request_id identifies the failure.\n\nRequires one of the following token scopes: companies.","requestBody":"5179bbc4-ccee-4122-9b80-c941eee7dcfa","method":"post","type":"path","servers":["4ca8b996-e74f-447c-8937-bc591ab08d00"],"path":"/business/companies/search","baseUrlOptions":["https://api.tryfuse.ai/api/v1"],"title":"Run a company search","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.filters.nameLike.items.0":"\u003cstring>","body.filters.domains.items.0":"\u003cstring>","body.filters.keywords.items.0":"\u003cstring>","body.filters.status.items.0.value":"\u003cstring>","body.filters.status.items.0.label":"\u003cstring>","body.filters.tags.items.0.value":"\u003cstring>","body.filters.tags.items.0.label":"\u003cstring>","body.filters.industriesV2.items.0.value":"\u003cstring>","body.filters.industriesV2.items.0.label":"\u003cstring>","body.filters.linkedinIndustries.items.0.value":"\u003cstring>","body.filters.linkedinIndustries.items.0.label":"\u003cstring>","body.filters.crunchbaseCategories.items.0.value":"\u003cstring>","body.filters.crunchbaseCategories.items.0.label":"\u003cstring>","body.filters.crunchbaseCategoryGroups.items.0":"\u003cstring>","body.filters.naicsCodes.items.0.value":"\u003cstring>","body.filters.naicsCodes.items.0.label":"\u003cstring>","body.filters.headquartersCountryCode.items.0.value":"\u003cstring>","body.filters.headquartersCountryCode.items.0.label":"\u003cstring>","body.filters.headquartersStateName.items.0.value":"\u003cstring>","body.filters.headquartersStateName.items.0.label":"\u003cstring>","body.filters.headquartersCity.items.0":"\u003cstring>","body.filters.employeeCountV2.min":123,"body.filters.employeeCountV2.max":123,"body.filters.revenueUSD.min":123,"body.filters.revenueUSD.max":123,"body.filters.totalFundingUSD.min":123,"body.filters.totalFundingUSD.max":123,"body.filters.lastFundingUSD.min":123,"body.filters.lastFundingUSD.max":123,"body.filters.stage.items.0.value":"\u003cstring>","body.filters.stage.items.0.label":"\u003cstring>","body.filters.technologies.items.0.value":"\u003cstring>","body.filters.technologies.items.0.label":"\u003cstring>","body.filters.investors.items.0.value":"\u003cstring>","body.filters.investors.items.0.label":"\u003cstring>","body.filters.foundedOn.start":"\u003cstring>","body.filters.foundedOn.end":"\u003cstring>","body.filters.lastFundedOn.start":"\u003cstring>","body.filters.lastFundedOn.end":"\u003cstring>","body.filters.acceleratorsV2.items.0.value":"\u003cstring>","body.filters.acceleratorsV2.items.0.label":"\u003cstring>","body.filters.fortuneRankings.items.0.value":"\u003cstring>","body.filters.fortuneRankings.items.0.label":"\u003cstring>","body.filters.officeLocationsV2.items.0.value":"\u003cstring>","body.filters.officeLocationsV2.items.0.label":"\u003cstring>","body.filters.linkedinSlugs.items.0":"\u003cstring>","body.savedSearchId":"\u003cstring>","body.savedSearchName":"\u003cstring>","body.query":"\u003cstring>","body.size":25,"body.cursor.oneOf.0":"\u003cstring>"}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"type":"object","properties":{"nameLike":{"type":"array","items":{"type":"string","maxLength":500,"uniqueKey":"filters.nameLike.items.[INDEX]","typeLabel":"string"},"description":"Free text: company-name fragments of at most 500 chars each, matched fuzzily against the company NAME only (never the description). Several fragments are OR-joined (provider `nameLike.anyOf`); resolve a real company to its canonical name with GET /companies/autocomplete?field=company.","uniqueKey":"filters.nameLike","typeLabel":"string[]"},"domains":{"type":"array","items":{"type":"string","uniqueKey":"filters.domains.items.[INDEX]","typeLabel":"string"},"description":"Free text: company website domains (e.g. stripe.com). A scheme, a www. prefix, a path and the letter case are all stripped before the search, so https://www.Stripe.com/pricing and stripe.com behave the same; a value that is not a domain at all is dropped. Several domains are OR-joined.","uniqueKey":"filters.domains","typeLabel":"string[]"},"keywords":{"type":"array","items":{"type":"string","uniqueKey":"filters.keywords.items.[INDEX]","typeLabel":"string"},"description":"Free-text keywords matched against company names and descriptions; any may match.","uniqueKey":"filters.keywords","typeLabel":"string[]"},"status":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.status.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.status.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.status.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.status.items.[INDEX]","typeLabel":"object"},"description":"Operating-status entries whose `value` is one of exactly: active, acquired, closed (the `statuses` list in GET /companies/filter-options). An off-list value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`). The provider ignores an exclude list on this field, so an exclusion is sent as the statuses that were NOT excluded, which also drops companies whose status is unknown. This filter ANDs with the others.","uniqueKey":"filters.status","typeLabel":"object[]"},"tags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.tags.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.tags.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.tags.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.tags.items.[INDEX]","typeLabel":"object"},"description":"Company-tag entries whose `value` is a slug from `companyTags` in GET /companies/filter-options: raised-from-top-vc, venture-backed-startup, is-government, is-school. An off-list value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.tags","typeLabel":"object[]"},"industriesV2":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.industriesV2.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.industriesV2.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.industriesV2.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.industriesV2.items.[INDEX]","typeLabel":"object"},"description":"Industry entries whose `value` is one of the `fiberIndustries` values in GET /companies/filter-options, copied exactly as listed (e.g. Software, Finance). An off-list value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.industriesV2","typeLabel":"object[]"},"linkedinIndustries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.linkedinIndustries.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.linkedinIndustries.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.linkedinIndustries.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.linkedinIndustries.items.[INDEX]","typeLabel":"object"},"description":"LinkedIn-industry entries whose `value` is one of the `linkedinIndustries` values in GET /companies/filter-options, copied exactly as listed (e.g. Software Development) — a much finer taxonomy than `industriesV2`. An off-list value is not rejected: the search comes back empty with no error naming the field, so check the value against the list first. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.linkedinIndustries","typeLabel":"object[]"},"crunchbaseCategories":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.crunchbaseCategories.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.crunchbaseCategories.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.crunchbaseCategories.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.crunchbaseCategories.items.[INDEX]","typeLabel":"object"},"description":"Crunchbase-category entries whose `value` is one of the `crunchbaseIndustries` values in GET /companies/filter-options, copied exactly as listed (e.g. Financial Services). An off-list value is not rejected: the search comes back empty with no error naming the field, so check the value against the list first. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.crunchbaseCategories","typeLabel":"object[]"},"crunchbaseCategoryGroups":{"type":"array","items":{"type":"string","uniqueKey":"filters.crunchbaseCategoryGroups.items.[INDEX]","typeLabel":"string"},"description":"Crunchbase category groups as plain strings copied verbatim (case-sensitive) from `crunchbaseCategoryGroups` in GET /companies/filter-options (e.g. Financial Services) — the broad parent of `crunchbaseCategories`. An off-list value is not rejected: the search comes back empty with no error naming the field, so check the value against the list first. Several groups are OR-joined (provider `anyOf`); this filter has no exclude form.","uniqueKey":"filters.crunchbaseCategoryGroups","typeLabel":"string[]"},"naicsCodes":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.naicsCodes.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.naicsCodes.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.naicsCodes.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.naicsCodes.items.[INDEX]","typeLabel":"object"},"description":"NAICS entries whose `value` is the code, not the title (`naicsCodes[].code` in GET /companies/filter-options, e.g. 513210 for Software Publishers; 2- to 6-digit codes are all accepted, a shorter code being the broader sector). An off-list value is not rejected: the search comes back empty with no error naming the field, so check the value against the list first. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.naicsCodes","typeLabel":"object[]"},"headquartersCountryCode":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.headquartersCountryCode.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.headquartersCountryCode.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.headquartersCountryCode.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.headquartersCountryCode.items.[INDEX]","typeLabel":"object"},"description":"Headquarters-country entries whose `value` is the country's three-letter `apiCode` from `countries` in GET /companies/filter-options (e.g. USA, DEU). The two-letter `isoCodeAlpha2` in the same row (US, DE) is also accepted and converted to the `apiCode`. Any other value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.headquartersCountryCode","typeLabel":"object[]"},"headquartersStateName":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.headquartersStateName.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.headquartersStateName.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.headquartersStateName.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.headquartersStateName.items.[INDEX]","typeLabel":"object"},"description":"Headquarters state/province entries whose `value` is the full state or province name (e.g. Florida, California).","uniqueKey":"filters.headquartersStateName","typeLabel":"object[]"},"headquartersCity":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"filters.headquartersCity.items.[INDEX]","typeLabel":"string"},"maxItems":25,"description":"Up to 25 fully qualified place names from GET /companies/autocomplete?field=location (e.g. Dallas, Texas, United States); each is geocoded independently to its city bounds and the areas are OR-ed together (no exclusion). A name that geocodes to nothing is dropped and the search runs on the names that did resolve — take the values from the typeahead so every one of them counts — and only when NOT ONE of them resolves is the search refused rather than run worldwide (422 CITY_FILTER_UNRESOLVED).","uniqueKey":"filters.headquartersCity","typeLabel":"string[]"},"employeeCountV2":{"type":"object","properties":{"min":{"type":"number","description":"Lower bound, inclusive — except on `employeeCountV2`, whose lower bound is exclusive (see that field). 0 or less is no bound.","uniqueKey":"filters.employeeCountV2.min","typeLabel":"number"},"max":{"type":"number","description":"Inclusive upper bound; 0 or less is no bound.","uniqueKey":"filters.employeeCountV2.max","typeLabel":"number"}},"description":"Headcount range `{ min?, max? }`; any whole number is taken on either side and is used as sent — the values the search UI offers (1, 10, 50, 200, 500, 1000, 5000, 10000) are its own vocabulary, not a constraint here. The lower bound is EXCLUSIVE and the upper bound inclusive, so `{ min: 50 }` matches companies with MORE than 50 employees, and `{ min: 300, max: 320 }` matches 301 to 320. Inverted bounds are read the other way round, and an equal pair keeps only the lower bound, because the provider rejects a range whose bounds meet.","uniqueKey":"filters.employeeCountV2","typeLabel":"object"},"revenueUSD":{"type":"object","properties":{"min":{"type":"number","description":"Lower bound, inclusive — except on `employeeCountV2`, whose lower bound is exclusive (see that field). 0 or less is no bound.","uniqueKey":"filters.revenueUSD.min","typeLabel":"number"},"max":{"type":"number","description":"Inclusive upper bound; 0 or less is no bound.","uniqueKey":"filters.revenueUSD.max","typeLabel":"number"}},"description":"Estimated annual revenue range `{ min?, max? }`; the accepted values are whole US dollars, not millions (5000000 means $5M), and both bounds are inclusive.","uniqueKey":"filters.revenueUSD","typeLabel":"object"},"totalFundingUSD":{"type":"object","properties":{"min":{"type":"number","description":"Lower bound, inclusive — except on `employeeCountV2`, whose lower bound is exclusive (see that field). 0 or less is no bound.","uniqueKey":"filters.totalFundingUSD.min","typeLabel":"number"},"max":{"type":"number","description":"Inclusive upper bound; 0 or less is no bound.","uniqueKey":"filters.totalFundingUSD.max","typeLabel":"number"}},"description":"Total funding raised range `{ min?, max? }`; the accepted values are whole US dollars, not millions (5000000 means $5M), and both bounds are inclusive.","uniqueKey":"filters.totalFundingUSD","typeLabel":"object"},"lastFundingUSD":{"type":"object","properties":{"min":{"type":"number","description":"Lower bound, inclusive — except on `employeeCountV2`, whose lower bound is exclusive (see that field). 0 or less is no bound.","uniqueKey":"filters.lastFundingUSD.min","typeLabel":"number"},"max":{"type":"number","description":"Inclusive upper bound; 0 or less is no bound.","uniqueKey":"filters.lastFundingUSD.max","typeLabel":"number"}},"description":"Size range of the most recent funding round `{ min?, max? }`; the accepted values are whole US dollars, not millions (5000000 means $5M), and both bounds are inclusive.","uniqueKey":"filters.lastFundingUSD","typeLabel":"object"},"stage":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.stage.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.stage.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.stage.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.stage.items.[INDEX]","typeLabel":"object"},"description":"Funding-stage entries whose `value` is one of exactly: pre_seed, seed, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, series_i, series_j, public, acquired, closed, private_equity, venture_other, no_funding_yet, unknown (the `fundingStages` list in GET /companies/filter-options). An off-list value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.stage","typeLabel":"object[]"},"technologies":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.technologies.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.technologies.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.technologies.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.technologies.items.[INDEX]","typeLabel":"object"},"description":"Technology-in-use entries whose `value` is a name from the provider's predefined technology vocabulary, forwarded verbatim, so it must carry the product's own spelling and casing — e.g. Salesforce, Kubernetes, Next.js, Google Analytics, and `AWS` for Amazon Web Services. No endpoint serves this vocabulary yet; the product's own picker offers a curated 141-name subset. An off-list value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.technologies","typeLabel":"object[]"},"investors":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.investors.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.investors.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.investors.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.investors.items.[INDEX]","typeLabel":"object"},"description":"Investor entries whose `value` is the investor's website domain — resolve names with GET /companies/autocomplete?field=company\u0026orgType=investor and send the `domain` from that response, never the investor's name. An off-list value is not rejected: the search comes back empty with no error naming the field, so check the value against the list first. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.investors","typeLabel":"object[]"},"foundedOn":{"type":"object","properties":{"start":{"type":"string","description":"Earliest date, ISO-8601 (e.g. 2020-01-01).","uniqueKey":"filters.foundedOn.start","typeLabel":"string"},"end":{"type":"string","description":"Latest date, ISO-8601 (e.g. 2024-12-31).","uniqueKey":"filters.foundedOn.end","typeLabel":"string"}},"description":"Founding-date range `{ start?, end? }` as ISO-8601 dates.","uniqueKey":"filters.foundedOn","typeLabel":"object"},"lastFundedOn":{"type":"object","properties":{"start":{"type":"string","description":"Earliest date, ISO-8601 (e.g. 2020-01-01).","uniqueKey":"filters.lastFundedOn.start","typeLabel":"string"},"end":{"type":"string","description":"Latest date, ISO-8601 (e.g. 2024-12-31).","uniqueKey":"filters.lastFundedOn.end","typeLabel":"string"}},"description":"Date range of the most recent funding round, `{ start?, end? }` as ISO-8601 dates.","uniqueKey":"filters.lastFundedOn","typeLabel":"object"},"acceleratorsV2":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.acceleratorsV2.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.acceleratorsV2.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.acceleratorsV2.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.acceleratorsV2.items.[INDEX]","typeLabel":"object"},"description":"Accelerator entries whose `value` is the `acceleratorSlug` from `accelerators` in GET /companies/filter-options (e.g. ycombinator, techstars); the `acceleratorName` in the same row is NOT accepted. An off-list value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.acceleratorsV2","typeLabel":"object[]"},"fortuneRankings":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.fortuneRankings.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.fortuneRankings.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.fortuneRankings.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.fortuneRankings.items.[INDEX]","typeLabel":"object"},"description":"Ranking-list entries whose `value` is one of exactly: fortune-500, fortune-1000, forbes-global-2000 (the `fortuneRankings` list in GET /companies/filter-options; fortune-1000 contains fortune-500). Any other value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`). The provider takes an include list only here, and the tiers nest, so an exclude value cannot be honoured and is ignored. This filter ANDs with the others.","uniqueKey":"filters.fortuneRankings","typeLabel":"object[]"},"officeLocationsV2":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500,"description":"The filter value — see the field's own description for its vocabulary.","isRequired":true,"uniqueKey":"filters.officeLocationsV2.items.[INDEX].value","typeLabel":"string"},"label":{"type":"string","minLength":1,"maxLength":500,"description":"Display label for the value (required; repeat the value when you have no label).","isRequired":true,"uniqueKey":"filters.officeLocationsV2.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes companies carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.officeLocationsV2.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.officeLocationsV2.items.[INDEX]","typeLabel":"object"},"description":"Office-location entries whose `value` is a country's three-letter `apiCode` from `countries` in GET /companies/filter-options (e.g. USA) — the same vocabulary as `headquartersCountryCode`, but matching ANY office rather than only the headquarters. The two-letter `isoCodeAlpha2` (US) is also accepted and converted to the `apiCode`. Any other value is refused with 422 SEARCH_FILTERS_INVALID, whose `details.param` names this filter and `details.values` the entry. Include values are OR-joined (provider `anyOf`) and every exclude value is removed (`noneOf`); this filter ANDs with the others.","uniqueKey":"filters.officeLocationsV2","typeLabel":"object[]"},"linkedinSlugs":{"type":"array","items":{"type":"string","uniqueKey":"filters.linkedinSlugs.items.[INDEX]","typeLabel":"string"},"description":"Free text: LinkedIn company slugs (e.g. stripe). A full company URL is accepted and reduced to the part after linkedin.com/company/, and the value is lower-cased, because the provider matches the slug exactly. Several slugs are OR-joined.","uniqueKey":"filters.linkedinSlugs","typeLabel":"string[]"}},"description":"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.","uniqueKey":"filters","typeLabel":"object"},"savedSearchId":{"type":"string","description":"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).","uniqueKey":"savedSearchId","typeLabel":"string"},"savedSearchName":{"type":"string","minLength":1,"maxLength":255,"description":"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.","uniqueKey":"savedSearchName","typeLabel":"string"},"query":{"type":"string","minLength":1,"maxLength":2000,"description":"Natural-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.","uniqueKey":"query","typeLabel":"string"},"size":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Companies per page (1-100, default 25); the search pre-checks 1 credit per requested company and debits 1 credit per company returned.","uniqueKey":"size","typeLabel":"integer"},"cursor":{"oneOf":[{"type":"string","description":"The `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.","uniqueKey":"cursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"The `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.","uniqueKey":"cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"cursor","typeLabel":"string | null"}},"description":"Exactly one filter source — `filters`, `savedSearchId`, `savedSearchName` or `query` — plus optional paging.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"filters":{"nameLike":["\u003cstring>"],"domains":["\u003cstring>"],"keywords":["\u003cstring>"],"status":[{"value":"\u003cstring>","label":"\u003cstring>"}],"tags":[{"value":"\u003cstring>","label":"\u003cstring>"}],"industriesV2":[{"value":"\u003cstring>","label":"\u003cstring>"}],"linkedinIndustries":[{"value":"\u003cstring>","label":"\u003cstring>"}],"crunchbaseCategories":[{"value":"\u003cstring>","label":"\u003cstring>"}],"crunchbaseCategoryGroups":["\u003cstring>"],"naicsCodes":[{"value":"\u003cstring>","label":"\u003cstring>"}],"headquartersCountryCode":[{"value":"\u003cstring>","label":"\u003cstring>"}],"headquartersStateName":[{"value":"\u003cstring>","label":"\u003cstring>"}],"headquartersCity":["\u003cstring>"],"employeeCountV2":{"min":123,"max":123},"revenueUSD":{"min":123,"max":123},"totalFundingUSD":{"min":123,"max":123},"lastFundingUSD":{"min":123,"max":123},"stage":[{"value":"\u003cstring>","label":"\u003cstring>"}],"technologies":[{"value":"\u003cstring>","label":"\u003cstring>"}],"investors":[{"value":"\u003cstring>","label":"\u003cstring>"}],"foundedOn":{"start":"\u003cstring>","end":"\u003cstring>"},"lastFundedOn":{"start":"\u003cstring>","end":"\u003cstring>"},"acceleratorsV2":[{"value":"\u003cstring>","label":"\u003cstring>"}],"fortuneRankings":[{"value":"\u003cstring>","label":"\u003cstring>"}],"officeLocationsV2":[{"value":"\u003cstring>","label":"\u003cstring>"}],"linkedinSlugs":["\u003cstring>"]},"savedSearchId":"\u003cstring>","savedSearchName":"\u003cstring>","query":"\u003cstring>","size":25,"cursor":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"80f05cec-22b9-4418-859b-0efb9e114a2d":{"description":"Success","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests permitted in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests remaining in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the current window resets."}},"content":{"application/json":{"schema":{"type":"object","required":["companies","total","nextCursor","filters"],"properties":{"companies":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["isSaved"],"properties":{"isSaved":{"type":"boolean","description":"Whether this company is already in one of your company lists.","isRequired":true,"uniqueKey":"companies.items.[INDEX].isSaved","typeLabel":"boolean"},"preferred_name":{"type":"string","uniqueKey":"companies.items.[INDEX].preferred_name","typeLabel":"string"},"names":{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].names.items.[INDEX]","typeLabel":"string"},"uniqueKey":"companies.items.[INDEX].names","typeLabel":"string[]"},"domains":{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].domains.items.[INDEX]","typeLabel":"string"},"uniqueKey":"companies.items.[INDEX].domains","typeLabel":"string[]"},"linkedin_primary_slug":{"oneOf":[{"type":"string","uniqueKey":"companies.items.[INDEX].linkedin_primary_slug.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"companies.items.[INDEX].linkedin_primary_slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].linkedin_primary_slug","typeLabel":"string | null"},"standard_industries":{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].standard_industries.items.[INDEX]","typeLabel":"string"},"uniqueKey":"companies.items.[INDEX].standard_industries","typeLabel":"string[]"},"naics_codes":{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].naics_codes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"companies.items.[INDEX].naics_codes","typeLabel":"string[]"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"companies.items.[INDEX].tags","typeLabel":"string[]"},"status_consensus":{"oneOf":[{"type":"string","uniqueKey":"companies.items.[INDEX].status_consensus.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"companies.items.[INDEX].status_consensus.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].status_consensus","typeLabel":"string | null"},"funding_stage":{"oneOf":[{"type":"string","uniqueKey":"companies.items.[INDEX].funding_stage.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"companies.items.[INDEX].funding_stage.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].funding_stage","typeLabel":"string | null"},"employee_count_consensus":{"oneOf":[{"type":"object","properties":{"gte":{"type":"integer","uniqueKey":"companies.items.[INDEX].employee_count_consensus.oneOf.0.gte","typeLabel":"integer"},"lte":{"type":"integer","uniqueKey":"companies.items.[INDEX].employee_count_consensus.oneOf.0.lte","typeLabel":"integer"}},"uniqueKey":"companies.items.[INDEX].employee_count_consensus.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"gte":{"type":"integer"},"lte":{"type":"integer"}},"uniqueKey":"companies.items.[INDEX].employee_count_consensus.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].employee_count_consensus","typeLabel":"object | null"},"location_consensus":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"companies.items.[INDEX].location_consensus.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"companies.items.[INDEX].location_consensus.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].location_consensus","typeLabel":"object | null"}},"uniqueKey":"companies.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"companies","typeLabel":"object[]"},"total":{"oneOf":[{"type":"integer","description":"True match count on the first page; null on every cursor page, where the upstream does not count.","isRequired":true,"uniqueKey":"total.oneOf.0","typeLabel":"integer"},{"type":"null","description":"True match count on the first page; null on every cursor page, where the upstream does not count.","isRequired":true,"uniqueKey":"total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"total","typeLabel":"integer | null"},"nextCursor":{"oneOf":[{"type":"string","description":"Send back as `cursor` with the same filter source for the next page; null on the last page.","isRequired":true,"uniqueKey":"nextCursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"Send back as `cursor` with the same filter source for the next page; null on the last page.","isRequired":true,"uniqueKey":"nextCursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nextCursor","typeLabel":"string | null"},"filters":{"type":"object","additionalProperties":true,"description":"The RESOLVED filters the search actually ran.","isRequired":true,"uniqueKey":"filters","typeLabel":"object"},"unresolvedCriteria":{"type":"array","items":{"type":"string","uniqueKey":"unresolvedCriteria.items.[INDEX]","typeLabel":"string"},"description":"Only when the source was `query`: criteria in the prose that could not be turned into a filter.","uniqueKey":"unresolvedCriteria","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"companies":[{"preferred_name":"Airbnb","names":["AirBed \u0026 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 \u0026 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 \u0026 Tourism","value":"Travel \u0026 Tourism","status":"include"},{"label":"Artificial Intelligence","value":"Artificial Intelligence","status":"exclude"}]}},"examples":{"Example":{"title":"Example","value":{"companies":[{"preferred_name":"Airbnb","names":["AirBed \u0026 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 \u0026 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 \u0026 Tourism","value":"Travel \u0026 Tourism","status":"include"},{"label":"Artificial Intelligence","value":"Artificial Intelligence","status":"exclude"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"2d02f891-95ed-4550-8bc3-c5c805ddb635":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d71c84cd-b587-445e-a7ae-63963c0e00f3":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"51ec8f6c-278b-42ed-b806-3160aba66b85":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1106b191-4153-469c-a62b-8971a60fd1fc":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3664c7b5-8d37-4899-b462-27be6d53897b":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"023aceae-f337-4a5c-b587-0e4b1a83ddc5":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"4025fab4-720b-4910-b76d-3945cbc2abf3":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"dd0c413e-1535-4838-b7ff-8694859f5af8":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"dd27a6eb-fbb2-4df9-924c-0dc243e9307d":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","param":"\u003cstring>","doc_url":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c6e56776-ecfc-4ee8-82be-ed866e43596e":{"basicAuth":{"type":"http","scheme":"basic","description":"Your API token (`af_…`) as the Basic-auth username, with an empty password.","scopes":[],"schemeName":"basicAuth"}}},"servers":{"4ca8b996-e74f-447c-8937-bc591ab08d00":{"url":"https://api.tryfuse.ai/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"Your API token (`af_…`) as the Basic-auth username, with an empty password.","scopes":[],"schemeName":"basicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"Your API token (`af_…`) as the Basic-auth username, with an empty password.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"}],"title":"basicAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"fuseai","siteName":"Fuse API","title":"Run a company search - Fuse API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T16:59:47.736Z","originalFileLocation":"api-reference/company-search/run-a-company-search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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 sending the returned filters together with the returned nextCursor as cursor (resending a query converts it again, which is slower and can build a different search); 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\u0026#x27;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\u0026#x27;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: 1 credit per requested company is pre-checked and 1 credit per company returned is debited. Errors: - 402 INSUFFICIENT_CREDITS — The balance does not cover the pre-check for this request; nothing was billed. - 404 SAVED_SEARCH_NOT_FOUND — No saved search of yours has that id or exact title. - 409 SAVED_SEARCH_NAME_AMBIGUOUS — Two of your saved searches share that title — reference it by savedSearchId instead. - 422 VALIDATION_FAILED — The request failed the declared schema; param names the offending key and message quotes the rule it broke. - 422 SAVED_SEARCH_TYPE_MISMATCH — The saved search exists but stores the other kind of filters; param is savedSearchId. - 422 SAVED_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. - 422 QUERY_FILTERS_INVALID — The natural-language query produced no usable filter; name concrete criteria. - 422 CITY_FILTER_UNRESOLVED — NOT ONE of the filters.headquartersCity names 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. param is filters.headquartersCity. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; param names the filter (e.g. filters.industriesV2) and values the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; technologies takes the provider\u0026#x27;s predefined names as its field description says. Correct the value and search again. - 429 RATE_LIMITED — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header. - 500 UNEXPECTED_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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fuse API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Run a company search - Fuse API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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 sending the returned filters together with the returned nextCursor as cursor (resending a query converts it again, which is slower and can build a different search); 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\u0026#x27;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\u0026#x27;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: 1 credit per requested company is pre-checked and 1 credit per company returned is debited. Errors: - 402 INSUFFICIENT_CREDITS — The balance does not cover the pre-check for this request; nothing was billed. - 404 SAVED_SEARCH_NOT_FOUND — No saved search of yours has that id or exact title. - 409 SAVED_SEARCH_NAME_AMBIGUOUS — Two of your saved searches share that title — reference it by savedSearchId instead. - 422 VALIDATION_FAILED — The request failed the declared schema; param names the offending key and message quotes the rule it broke. - 422 SAVED_SEARCH_TYPE_MISMATCH — The saved search exists but stores the other kind of filters; param is savedSearchId. - 422 SAVED_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. - 422 QUERY_FILTERS_INVALID — The natural-language query produced no usable filter; name concrete criteria. - 422 CITY_FILTER_UNRESOLVED — NOT ONE of the filters.headquartersCity names 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. param is filters.headquartersCity. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; param names the filter (e.g. filters.industriesV2) and values the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; technologies takes the provider\u0026#x27;s predefined names as its field description says. Correct the value and search again. - 429 RATE_LIMITED — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header. - 500 UNEXPECTED_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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fuse API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fuseai.mintlify.app/_mintlify/api/og/v2?division=Company+search\u0026amp;title=Run+a+company+search\u0026amp;description=Find+companies+by+a+plain-English+sentence+or+by+filters+%28industry%2C+headquarters+location%2C+headcount%2C+revenue%2C+funding+stage%2C+technologies%29%3A+name%2C+domains%2C+Link\u0026amp;theme=6edc0ab12d2194e24d86a864\u0026amp;signature=9bccbb4e442206daacd99d53257b2edf9e958a07517f3fe65730d2a16fa735e7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Run a company search - Fuse API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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 sending the returned filters together with the returned nextCursor as cursor (resending a query converts it again, which is slower and can build a different search); 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\u0026#x27;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\u0026#x27;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: 1 credit per requested company is pre-checked and 1 credit per company returned is debited. Errors: - 402 INSUFFICIENT_CREDITS — The balance does not cover the pre-check for this request; nothing was billed. - 404 SAVED_SEARCH_NOT_FOUND — No saved search of yours has that id or exact title. - 409 SAVED_SEARCH_NAME_AMBIGUOUS — Two of your saved searches share that title — reference it by savedSearchId instead. - 422 VALIDATION_FAILED — The request failed the declared schema; param names the offending key and message quotes the rule it broke. - 422 SAVED_SEARCH_TYPE_MISMATCH — The saved search exists but stores the other kind of filters; param is savedSearchId. - 422 SAVED_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. - 422 QUERY_FILTERS_INVALID — The natural-language query produced no usable filter; name concrete criteria. - 422 CITY_FILTER_UNRESOLVED — NOT ONE of the filters.headquartersCity names 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. param is filters.headquartersCity. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; param names the filter (e.g. filters.industriesV2) and values the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; technologies takes the provider\u0026#x27;s predefined names as its field description says. Correct the value and search again. - 429 RATE_LIMITED — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header. - 500 UNEXPECTED_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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fuseai.mintlify.app/_mintlify/api/og/v2?division=Company+search\u0026amp;title=Run+a+company+search\u0026amp;description=Find+companies+by+a+plain-English+sentence+or+by+filters+%28industry%2C+headquarters+location%2C+headcount%2C+revenue%2C+funding+stage%2C+technologies%29%3A+name%2C+domains%2C+Link\u0026amp;theme=6edc0ab12d2194e24d86a864\u0026amp;signature=9bccbb4e442206daacd99d53257b2edf9e958a07517f3fe65730d2a16fa735e7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fuseai/tzdaGJCdazH9bA6t/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fuse API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#22857C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/company-search/run-a-company-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fuseai.com/#organization\",\"name\":\"Fuse API\",\"url\":\"https://docs.fuseai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fuseai/HxYNa2W1WI8CM0N4/logo/light.svg?fit=max\u0026auto=format\u0026n=HxYNa2W1WI8CM0N4\u0026q=85\u0026s=c9afa73057eb802e14743fbb297c60d5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fuseai.com#website\",\"name\":\"Fuse API\",\"url\":\"https://docs.fuseai.com\",\"publisher\":{\"@id\":\"https://docs.fuseai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search#webpage\",\"url\":\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search\",\"name\":\"Run a company search\",\"description\":\"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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 sending the returned filters together with the returned nextCursor as cursor (resending a query converts it again, which is slower and can build a different search); 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: 1 credit per requested company is pre-checked and 1 credit per company returned is debited. Errors: - 402 INSUFFICIENT_CREDITS — The balance does not cover the pre-check for this request; nothing was billed. - 404 SAVED_SEARCH_NOT_FOUND — No saved search of yours has that id or exact title. - 409 SAVED_SEARCH_NAME_AMBIGUOUS — Two of your saved searches share that title — reference it by savedSearchId instead. - 422 VALIDATION_FAILED — The request failed the declared schema; param names the offending key and message quotes the rule it broke. - 422 SAVED_SEARCH_TYPE_MISMATCH — The saved search exists but stores the other kind of filters; param is savedSearchId. - 422 SAVED_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. - 422 QUERY_FILTERS_INVALID — The natural-language query produced no usable filter; name concrete criteria. - 422 CITY_FILTER_UNRESOLVED — NOT ONE of the filters.headquartersCity names 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. param is filters.headquartersCity. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; param names the filter (e.g. filters.industriesV2) and values the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; technologies takes the provider's predefined names as its field description says. Correct the value and search again. - 429 RATE_LIMITED — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header. - 500 UNEXPECTED_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.\",\"dateModified\":\"2026-10-29T16:59:47.736Z\",\"isPartOf\":{\"@id\":\"https://docs.fuseai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Company search\",\"item\":\"https://docs.fuseai.com/api-reference/company-search/get-the-accepted-company-search-filter-values\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Run a company search\",\"item\":\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search#apireference\",\"headline\":\"Run a company search\",\"name\":\"Run a company search\",\"description\":\"Find companies by a plain-English sentence or by filters (industry, headquarters location, headcount, revenue, funding stage, technologies): name, domains, LinkedIn page, firmographics and logo for each match, 1 credit per company returned. 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 sending the returned filters together with the returned nextCursor as cursor (resending a query converts it again, which is slower and can build a different search); 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: 1 credit per requested company is pre-checked and 1 credit per company returned is debited. Errors: - 402 INSUFFICIENT_CREDITS — The balance does not cover the pre-check for this request; nothing was billed. - 404 SAVED_SEARCH_NOT_FOUND — No saved search of yours has that id or exact title. - 409 SAVED_SEARCH_NAME_AMBIGUOUS — Two of your saved searches share that title — reference it by savedSearchId instead. - 422 VALIDATION_FAILED — The request failed the declared schema; param names the offending key and message quotes the rule it broke. - 422 SAVED_SEARCH_TYPE_MISMATCH — The saved search exists but stores the other kind of filters; param is savedSearchId. - 422 SAVED_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. - 422 QUERY_FILTERS_INVALID — The natural-language query produced no usable filter; name concrete criteria. - 422 CITY_FILTER_UNRESOLVED — NOT ONE of the filters.headquartersCity names 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. param is filters.headquartersCity. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take — an industry, tag, stage, status, country code, technology, accelerator or ranking list off its vocabulary; param names the filter (e.g. filters.industriesV2) and values the refused entry. Every one of those lists but technologies is served by GET /companies/filter-options; technologies takes the provider's predefined names as its field description says. Correct the value and search again. - 429 RATE_LIMITED — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header. - 500 UNEXPECTED_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.\",\"url\":\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fuseai.com/api-reference/company-search/run-a-company-search#webpage\"},\"dateModified\":\"2026-10-29T16:59:47.736Z\",\"publisher\":{\"@id\":\"https://docs.fuseai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fuseai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fuse API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Fuse API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Lists","pages":[{"title":"List the token owner's prospect lists","deprecated":null,"version":null,"openapi":"/openapi.json get /business/lists","href":"/api-reference/lists/list-the-token-owners-prospect-lists"},{"title":"Create a prospect list","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists","href":"/api-reference/lists/create-a-prospect-list"},{"title":"Get one list's metadata","deprecated":null,"version":null,"openapi":"/openapi.json get /business/lists/{listId}","href":"/api-reference/lists/get-one-lists-metadata"},{"title":"Delete a list","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/lists/{listId}","href":"/api-reference/lists/delete-a-list"},{"title":"Rename a list or move it between folders","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/lists/{listId}","href":"/api-reference/lists/rename-a-list-or-move-it-between-folders"},{"title":"Copy rows from one list into another","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/save-to-list","href":"/api-reference/lists/copy-rows-from-one-list-into-another"},{"title":"Build a company list from a contact list's companies","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/derive-company-list","href":"/api-reference/lists/build-a-company-list-from-a-contact-lists-companies"},{"title":"Distinct values a company list carries for a field","deprecated":null,"version":null,"openapi":"/openapi.json get /business/lists/{listId}/filter-values","href":"/api-reference/lists/distinct-values-a-company-list-carries-for-a-field"},{"title":"List a list's contacts (with ids and column values)","deprecated":null,"version":null,"openapi":"/openapi.json get /business/lists/{listId}/rows","href":"/api-reference/lists/list-a-lists-contacts-with-ids-and-column-values"},{"title":"Add existing contacts to a list (by id)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/members","href":"/api-reference/lists/add-existing-contacts-to-a-list-by-id"},{"title":"Remove contacts from a list","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/lists/{listId}/members","href":"/api-reference/lists/remove-contacts-from-a-list"},{"title":"Upload new contact data into a list (RAW upload)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/contacts","href":"/api-reference/lists/upload-new-contact-data-into-a-list-raw-upload"},{"title":"Enrich a list's contacts in place","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/enrich","href":"/api-reference/lists/enrich-a-lists-contacts-in-place"},{"title":"Push a list's contacts into a connected CRM","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/crm-push","href":"/api-reference/lists/push-a-lists-contacts-into-a-connected-crm"},{"title":"Presigned upload for a large import file","deprecated":null,"version":null,"openapi":"/openapi.json post /business/imports/presign","href":"/api-reference/lists/presigned-upload-for-a-large-import-file"},{"title":"Start an import (parse + suggested mapping)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/imports","href":"/api-reference/lists/start-an-import-parse-+-suggested-mapping"},{"title":"Commit an import into a list","deprecated":null,"version":null,"openapi":"/openapi.json post /business/imports/{importId}/commit","href":"/api-reference/lists/commit-an-import-into-a-list"}]},{"group":"Custom columns","pages":[{"title":"List a list's custom column definitions","deprecated":null,"version":null,"openapi":"/openapi.json get /business/lists/{listId}/columns","href":"/api-reference/custom-columns/list-a-lists-custom-column-definitions"},{"title":"Create a custom column on a list","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/columns","href":"/api-reference/custom-columns/create-a-custom-column-on-a-list"},{"title":"Delete a custom column (its values go with it)","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/lists/{listId}/columns/{columnId}","href":"/api-reference/custom-columns/delete-a-custom-column-its-values-go-with-it"},{"title":"Write custom column values (keyed by contact id)","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/lists/{listId}/columns/{columnId}/values","href":"/api-reference/custom-columns/write-custom-column-values-keyed-by-contact-id"}]},{"group":"Smart columns","pages":[{"title":"Add an AI column that researches every row","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/smart-columns","href":"/api-reference/smart-columns/add-an-ai-column-that-researches-every-row"},{"title":"Poll a smart-column run","deprecated":null,"version":null,"openapi":"/openapi.json get /business/lists/{listId}/smart-columns/{jobId}/status","href":"/api-reference/smart-columns/poll-a-smart-column-run"},{"title":"A smart column's definition and run state","deprecated":null,"version":null,"openapi":"/openapi.json get /business/lists/{listId}/smart-columns/{columnId}","href":"/api-reference/smart-columns/a-smart-columns-definition-and-run-state"},{"title":"Rename a smart column, change its prompt or providers","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/lists/{listId}/smart-columns/{columnId}","href":"/api-reference/smart-columns/rename-a-smart-column-change-its-prompt-or-providers"},{"title":"Run a smart column again","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/smart-columns/{columnId}/rerun","href":"/api-reference/smart-columns/run-a-smart-column-again"},{"title":"Where a smart-column cell's value came from","deprecated":null,"version":null,"openapi":"/openapi.json get /business/lists/{listId}/rows/{contactId}/columns/{columnId}/provenance","href":"/api-reference/smart-columns/where-a-smart-column-cells-value-came-from"}]},{"group":"Exports","pages":[{"title":"Start an async CSV export of a list (returns a jobId)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/lists/{listId}/export","href":"/api-reference/exports/start-an-async-csv-export-of-a-list-returns-a-jobid"},{"title":"Poll an export job (presigned download URL when completed)","deprecated":null,"version":null,"openapi":"/openapi.json get /business/exports/{jobId}","href":"/api-reference/exports/poll-an-export-job-presigned-download-url-when-completed"}]},{"group":"Campaigns","pages":[{"title":"List the token owner's campaigns with headline analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns","href":"/api-reference/campaigns/list-the-token-owners-campaigns-with-headline-analytics"},{"title":"Create a draft campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns","href":"/api-reference/campaigns/create-a-draft-campaign"},{"title":"Get a campaign's status","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns/{campaignId}","href":"/api-reference/campaigns/get-a-campaigns-status"},{"title":"Stop and delete a campaign","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/campaigns/{campaignId}","href":"/api-reference/campaigns/stop-and-delete-a-campaign"},{"title":"Update a campaign's settings","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/campaigns/{campaignId}","href":"/api-reference/campaigns/update-a-campaigns-settings"},{"title":"List a campaign's sequence steps","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns/{campaignId}/steps","href":"/api-reference/campaigns/list-a-campaigns-sequence-steps"},{"title":"Edit a sequence step","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/campaigns/{campaignId}/steps/{stepId}","href":"/api-reference/campaigns/edit-a-sequence-step"},{"title":"Approve (activate) a draft campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns/{campaignId}/approve","href":"/api-reference/campaigns/approve-activate-a-draft-campaign"},{"title":"Stop an active campaign (approve re-activates it)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns/{campaignId}/stop","href":"/api-reference/campaigns/stop-an-active-campaign-approve-re-activates-it"},{"title":"Copy a campaign as a fresh draft","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns/{campaignId}/duplicate","href":"/api-reference/campaigns/copy-a-campaign-as-a-fresh-draft"},{"title":"The personalization variables this campaign's steps can use","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns/{campaignId}/variables","href":"/api-reference/campaigns/the-personalization-variables-this-campaigns-steps-can-use"},{"title":"A campaign's headline metrics since `since`","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns/{campaignId}/stats","href":"/api-reference/campaigns/a-campaigns-headline-metrics-since-`since`"},{"title":"The campaign's leads with their per-step state","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns/{campaignId}/leads","href":"/api-reference/campaigns/the-campaigns-leads-with-their-per-step-state"},{"title":"Export the campaign's leads to CSV","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns/{campaignId}/leads/export","href":"/api-reference/campaigns/export-the-campaigns-leads-to-csv"},{"title":"Per-arm results of a campaign's A/B splits","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns/{campaignId}/split-results","href":"/api-reference/campaigns/per-arm-results-of-a-campaigns-ab-splits"}]},{"group":"Campaign steps","pages":[{"title":"Add a sequence step","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns/{campaignId}/steps","href":"/api-reference/campaign-steps/add-a-sequence-step"},{"title":"Remove a sequence step","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/campaigns/{campaignId}/steps/{stepId}","href":"/api-reference/campaign-steps/remove-a-sequence-step"},{"title":"Copy one arm of an A/B split into the other","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns/{campaignId}/steps/{stepId}/copy-arm","href":"/api-reference/campaign-steps/copy-one-arm-of-an-ab-split-into-the-other"},{"title":"Render the step for a sample lead without saving or sending","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns/{campaignId}/steps/{stepId}/generate","href":"/api-reference/campaign-steps/render-the-step-for-a-sample-lead-without-saving-or-sending"},{"title":"Rebuild the AI topic plan across the campaign's steps","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaigns/{campaignId}/steps/regenerate-topics","href":"/api-reference/campaign-steps/rebuild-the-ai-topic-plan-across-the-campaigns-steps"}]},{"group":"Knowledge hubs","pages":[{"title":"List the token owner's knowledge hubs","deprecated":null,"version":null,"openapi":"/openapi.json get /business/knowledge-hubs","href":"/api-reference/knowledge-hubs/list-the-token-owners-knowledge-hubs"},{"title":"Create a knowledge hub from websites","deprecated":null,"version":null,"openapi":"/openapi.json post /business/knowledge-hubs","href":"/api-reference/knowledge-hubs/create-a-knowledge-hub-from-websites"},{"title":"Make a hub the default one","deprecated":null,"version":null,"openapi":"/openapi.json post /business/knowledge-hubs/default","href":"/api-reference/knowledge-hubs/make-a-hub-the-default-one"},{"title":"Facts learned from the team's communications","deprecated":null,"version":null,"openapi":"/openapi.json get /business/knowledge-hubs/learned-facts","href":"/api-reference/knowledge-hubs/facts-learned-from-the-teams-communications"},{"title":"Discard a learned fact","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/knowledge-hubs/learned-facts/{factId}","href":"/api-reference/knowledge-hubs/discard-a-learned-fact"},{"title":"Correct a learned fact","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/knowledge-hubs/learned-facts/{factId}","href":"/api-reference/knowledge-hubs/correct-a-learned-fact"},{"title":"A hub's full detail","deprecated":null,"version":null,"openapi":"/openapi.json get /business/knowledge-hubs/{hubId}","href":"/api-reference/knowledge-hubs/a-hubs-full-detail"},{"title":"Delete a hub","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/knowledge-hubs/{hubId}","href":"/api-reference/knowledge-hubs/delete-a-hub"},{"title":"Update a hub's name, websites, or notes","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/knowledge-hubs/{hubId}","href":"/api-reference/knowledge-hubs/update-a-hubs-name-websites-or-notes"},{"title":"Re-crawl one of the hub's websites","deprecated":null,"version":null,"openapi":"/openapi.json post /business/knowledge-hubs/{hubId}/refresh","href":"/api-reference/knowledge-hubs/re-crawl-one-of-the-hubs-websites"},{"title":"The hub's knowledge pages","deprecated":null,"version":null,"openapi":"/openapi.json get /business/knowledge-hubs/{hubId}/pages","href":"/api-reference/knowledge-hubs/the-hubs-knowledge-pages"},{"title":"Add a custom knowledge page","deprecated":null,"version":null,"openapi":"/openapi.json post /business/knowledge-hubs/{hubId}/pages","href":"/api-reference/knowledge-hubs/add-a-custom-knowledge-page"},{"title":"Remove a knowledge page","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/knowledge-hubs/{hubId}/pages/{pageId}","href":"/api-reference/knowledge-hubs/remove-a-knowledge-page"},{"title":"Edit a page's title or content","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/knowledge-hubs/{hubId}/pages/{pageId}","href":"/api-reference/knowledge-hubs/edit-a-pages-title-or-content"},{"title":"Rebuild a page from the hub's sources","deprecated":null,"version":null,"openapi":"/openapi.json post /business/knowledge-hubs/{hubId}/pages/{pageId}/regenerate","href":"/api-reference/knowledge-hubs/rebuild-a-page-from-the-hubs-sources"},{"title":"Attach a document to one of the hub's notes","deprecated":null,"version":null,"openapi":"/openapi.json post /business/knowledge-hubs/{hubId}/attachments","href":"/api-reference/knowledge-hubs/attach-a-document-to-one-of-the-hubs-notes"},{"title":"A download URL for a note's attachment","deprecated":null,"version":null,"openapi":"/openapi.json get /business/knowledge-hubs/{hubId}/attachments/{noteId}","href":"/api-reference/knowledge-hubs/a-download-url-for-a-notes-attachment"},{"title":"Remove a note's attachment","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/knowledge-hubs/{hubId}/attachments/{noteId}","href":"/api-reference/knowledge-hubs/remove-a-notes-attachment"}]},{"group":"Analytics","pages":[{"title":"Campaigns analytics roll-up","deprecated":null,"version":null,"openapi":"/openapi.json get /business/analytics/campaigns","href":"/api-reference/analytics/campaigns-analytics-roll-up"},{"title":"Dialer analytics roll-up","deprecated":null,"version":null,"openapi":"/openapi.json get /business/analytics/dialer","href":"/api-reference/analytics/dialer-analytics-roll-up"},{"title":"Enrichment analytics roll-up","deprecated":null,"version":null,"openapi":"/openapi.json get /business/analytics/enrichment","href":"/api-reference/analytics/enrichment-analytics-roll-up"},{"title":"Website intent analytics roll-up","deprecated":null,"version":null,"openapi":"/openapi.json get /business/analytics/website-intent","href":"/api-reference/analytics/website-intent-analytics-roll-up"},{"title":"Agents analytics roll-up","deprecated":null,"version":null,"openapi":"/openapi.json get /business/analytics/agents","href":"/api-reference/analytics/agents-analytics-roll-up"}]},{"group":"Website intent","pages":[{"title":"The deanonymized visitor feed","deprecated":null,"version":null,"openapi":"/openapi.json get /business/website-visitors","href":"/api-reference/website-intent/the-deanonymized-visitor-feed"},{"title":"Tracking config: domains, pages, script, credit limit","deprecated":null,"version":null,"openapi":"/openapi.json get /business/website-tracking","href":"/api-reference/website-intent/tracking-config:-domains-pages-script-credit-limit"},{"title":"Update tracked domains/pages or the monthly credit limit","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/website-tracking","href":"/api-reference/website-intent/update-tracked-domainspages-or-the-monthly-credit-limit"}]},{"group":"Account","pages":[{"title":"Connected sending accounts by channel","deprecated":null,"version":null,"openapi":"/openapi.json get /business/accounts","href":"/api-reference/account/connected-sending-accounts-by-channel"},{"title":"Teammates (id, name, email)","deprecated":null,"version":null,"openapi":"/openapi.json get /business/team/members","href":"/api-reference/account/teammates-id-name-email"},{"title":"The writing styles AI campaigns accept","deprecated":null,"version":null,"openapi":"/openapi.json get /business/writing-styles","href":"/api-reference/account/the-writing-styles-ai-campaigns-accept"},{"title":"Which CRMs the team has connected","deprecated":null,"version":null,"openapi":"/openapi.json get /business/integrations","href":"/api-reference/account/which-crms-the-team-has-connected"},{"title":"Poll any async job","deprecated":null,"version":null,"openapi":"/openapi.json get /business/jobs/{jobId}","href":"/api-reference/account/poll-any-async-job"},{"title":"The credit spend ledger","deprecated":null,"version":null,"openapi":"/openapi.json post /business/credits/usage","href":"/api-reference/account/the-credit-spend-ledger"},{"title":"Get the token owner's identity","deprecated":null,"version":null,"openapi":"/openapi.json get /business/me","href":"/api-reference/account/get-the-token-owners-identity"},{"title":"Get the token owner's credit balance","deprecated":null,"version":null,"openapi":"/openapi.json get /business/credits","href":"/api-reference/account/get-the-token-owners-credit-balance"}]},{"group":"Data","pages":[{"title":"Get your key's usage plan","deprecated":null,"version":null,"openapi":"/openapi.json get /business/data/pricing","href":"/api-reference/data/get-your-keys-usage-plan"},{"title":"Count people matching a search (free)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/people/count","href":"/api-reference/data/count-people-matching-a-search-free"},{"title":"Count companies matching a search (free)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/companies/count","href":"/api-reference/data/count-companies-matching-a-search-free"},{"title":"Find a company's domain, LinkedIn page and logo (free)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/companies/resolve","href":"/api-reference/data/find-a-companys-domain-linkedin-page-and-logo-free"},{"title":"Find a person's email","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/people/email","href":"/api-reference/data/find-a-persons-email"},{"title":"Find a person's phone","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/people/phone","href":"/api-reference/data/find-a-persons-phone"},{"title":"Verify an email address","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/emails/verify","href":"/api-reference/data/verify-an-email-address"},{"title":"Find emails and phones for up to 100 people","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/people/enrich-jobs","href":"/api-reference/data/find-emails-and-phones-for-up-to-100-people"},{"title":"Get a people enrichment job's progress and rows","deprecated":null,"version":null,"openapi":"/openapi.json get /business/data/people/enrich-jobs/{jobId}","href":"/api-reference/data/get-a-people-enrichment-jobs-progress-and-rows"}]},{"group":"Prospect search","pages":[{"title":"Get the accepted prospect-search filter values","deprecated":null,"version":null,"openapi":"/openapi.json get /business/prospects/filter-options","href":"/api-reference/prospect-search/get-the-accepted-prospect-search-filter-values"},{"title":"Suggest values for a free-text search field","deprecated":null,"version":null,"openapi":"/openapi.json get /business/prospects/autocomplete","href":"/api-reference/prospect-search/suggest-values-for-a-free-text-search-field"},{"title":"Run a people search","deprecated":null,"version":null,"openapi":"/openapi.json post /business/prospects/search","href":"/api-reference/prospect-search/run-a-people-search"},{"title":"Save people-search results into a list","deprecated":null,"version":null,"openapi":"/openapi.json post /business/prospects/search/save-to-list","href":"/api-reference/prospect-search/save-people-search-results-into-a-list"}]},{"group":"Scheduled sends","pages":[{"title":"The campaign's send queue by status","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns/{campaignId}/scheduled-sends","href":"/api-reference/scheduled-sends/the-campaigns-send-queue-by-status"},{"title":"Edit a queued send's copy or time before it goes out","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/scheduled-sends/{sendId}","href":"/api-reference/scheduled-sends/edit-a-queued-sends-copy-or-time-before-it-goes-out"},{"title":"Skip one queued send","deprecated":null,"version":null,"openapi":"/openapi.json post /business/scheduled-sends/{sendId}/skip","href":"/api-reference/scheduled-sends/skip-one-queued-send"},{"title":"Approve queued sends awaiting review","deprecated":null,"version":null,"openapi":"/openapi.json post /business/scheduled-sends/approve","href":"/api-reference/scheduled-sends/approve-queued-sends-awaiting-review"},{"title":"Decline queued sends awaiting review","deprecated":null,"version":null,"openapi":"/openapi.json post /business/scheduled-sends/decline","href":"/api-reference/scheduled-sends/decline-queued-sends-awaiting-review"}]},{"group":"Campaign templates","pages":[{"title":"The workspace's saved campaign templates","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaign-templates","href":"/api-reference/campaign-templates/the-workspaces-saved-campaign-templates"},{"title":"Save a campaign's sequence as a reusable template","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaign-templates","href":"/api-reference/campaign-templates/save-a-campaigns-sequence-as-a-reusable-template"},{"title":"Delete a template","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/campaign-templates/{campaignTemplateId}","href":"/api-reference/campaign-templates/delete-a-template"}]},{"group":"Agents","pages":[{"title":"The agent kinds the wizard offers","deprecated":null,"version":null,"openapi":"/openapi.json get /business/agents/signal-types","href":"/api-reference/agents/the-agent-kinds-the-wizard-offers"},{"title":"The token owner's agents across every kind","deprecated":null,"version":null,"openapi":"/openapi.json get /business/agents","href":"/api-reference/agents/the-token-owners-agents-across-every-kind"},{"title":"Create a web monitor agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/web-monitor","href":"/api-reference/agents/create-a-web-monitor-agent"},{"title":"Create a person starting new job agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/person-starting-new-job","href":"/api-reference/agents/create-a-person-starting-new-job-agent"},{"title":"Create a linkedin posts agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/linkedin-posts","href":"/api-reference/agents/create-a-linkedin-posts-agent"},{"title":"Create a person discovery via filters agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/person-discovery-via-filters","href":"/api-reference/agents/create-a-person-discovery-via-filters-agent"},{"title":"Create a job postings agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/job-postings","href":"/api-reference/agents/create-a-job-postings-agent"},{"title":"Create a job posting in location agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/job-posting-in-location","href":"/api-reference/agents/create-a-job-posting-in-location-agent"},{"title":"Create a first person hired in company department agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/first-person-hired-in-company-department","href":"/api-reference/agents/create-a-first-person-hired-in-company-department-agent"},{"title":"Create a first person hired internationally agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/first-person-hired-internationally","href":"/api-reference/agents/create-a-first-person-hired-internationally-agent"},{"title":"Create a company headcount growth agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/company-headcount-growth","href":"/api-reference/agents/create-a-company-headcount-growth-agent"},{"title":"Create a company headcount growth over baseline agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/company-headcount-growth-over-baseline","href":"/api-reference/agents/create-a-company-headcount-growth-over-baseline-agent"},{"title":"Create a company department headcount agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/company-department-headcount","href":"/api-reference/agents/create-a-company-department-headcount-agent"},{"title":"Create a company employee job location in two countries agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/company-employee-job-location-in-two-countries","href":"/api-reference/agents/create-a-company-employee-job-location-in-two-countries-agent"},{"title":"Create a funding announcements agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/funding-announcements","href":"/api-reference/agents/create-a-funding-announcements-agent"},{"title":"Create a people watcher agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/people-watcher","href":"/api-reference/agents/create-a-people-watcher-agent"},{"title":"Create a companies watcher agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/companies-watcher","href":"/api-reference/agents/create-a-companies-watcher-agent"},{"title":"Create a job changes watcher agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/job-changes-watcher","href":"/api-reference/agents/create-a-job-changes-watcher-agent"},{"title":"Create a linkedin profile agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/linkedin-profile","href":"/api-reference/agents/create-a-linkedin-profile-agent"},{"title":"Create a linkedin post agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/linkedin-post","href":"/api-reference/agents/create-a-linkedin-post-agent"},{"title":"Canonical values for agent config filters","deprecated":null,"version":null,"openapi":"/openapi.json get /business/agents/autocomplete","href":"/api-reference/agents/canonical-values-for-agent-config-filters"},{"title":"An agent's config as the drawer shows it","deprecated":null,"version":null,"openapi":"/openapi.json get /business/agents/{agentId}","href":"/api-reference/agents/an-agents-config-as-the-drawer-shows-it"},{"title":"Delete an agent (409 while a run is processing)","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/agents/{agentId}","href":"/api-reference/agents/delete-an-agent-409-while-a-run-is-processing"},{"title":"Update a draft agent's config (partial)","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/agents/{agentId}","href":"/api-reference/agents/update-a-draft-agents-config-partial"},{"title":"Start a draft agent (spends credits)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/{agentId}/activate","href":"/api-reference/agents/start-a-draft-agent-spends-credits"},{"title":"Pause an agent (one-way, there is no resume)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/{agentId}/stop","href":"/api-reference/agents/pause-an-agent-one-way-there-is-no-resume"},{"title":"Copy an agent as a fresh draft","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/{agentId}/duplicate","href":"/api-reference/agents/copy-an-agent-as-a-fresh-draft"}]},{"group":"Research","pages":[{"title":"The research providers a run can use","deprecated":null,"version":null,"openapi":"/openapi.json get /business/research/providers","href":"/api-reference/research/the-research-providers-a-run-can-use"},{"title":"Research runs currently in flight","deprecated":null,"version":null,"openapi":"/openapi.json get /business/research/runs","href":"/api-reference/research/research-runs-currently-in-flight"},{"title":"Start a Deep Research run","deprecated":null,"version":null,"openapi":"/openapi.json post /business/research/runs","href":"/api-reference/research/start-a-deep-research-run"},{"title":"A research run's state, report, and result list","deprecated":null,"version":null,"openapi":"/openapi.json get /business/research/runs/{runId}","href":"/api-reference/research/a-research-runs-state-report-and-result-list"},{"title":"A research run's progress events","deprecated":null,"version":null,"openapi":"/openapi.json get /business/research/runs/{runId}/events","href":"/api-reference/research/a-research-runs-progress-events"},{"title":"Cancel an in-flight research run","deprecated":null,"version":null,"openapi":"/openapi.json post /business/research/runs/{runId}/cancel","href":"/api-reference/research/cancel-an-in-flight-research-run"}]},{"group":"Company search","pages":[{"title":"Get the accepted company-search filter values","deprecated":null,"version":null,"openapi":"/openapi.json get /business/companies/filter-options","href":"/api-reference/company-search/get-the-accepted-company-search-filter-values"},{"title":"Suggest values for company and location filters","description":"Resolves free-text input to canonical company-filter values; two characters minimum. `field=company` returns company names with their `domain` when known — send `name` to `nameLike`, or `domain` to `domains`; add `orgType=investor` to search investors instead, whose `domain` is the value the `investors` filter takes. `field=location` returns fully qualified place names (\"Dallas, Texas, United States\") which are exactly what the `headquartersCity` filter takes — the qualification is what lets the geocoder tell six same-named cities apart, so send the whole string. Note that `officeLocationsV2` is a different filter and takes country `apiCode`s from GET /companies/filter-options, not these place names. Same vocabulary as the product's type-ahead; free.\n\nErrors:\n- `422` `VALIDATION_FAILED` — The request failed the declared schema; `param` names the offending key and `message` quotes the rule it broke.\n- `429` `RATE_LIMITED` — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.\n- `500` `UNEXPECTED_ERROR` — The request failed inside the service; nothing was billed and the request_id identifies the failure.\n\nRequires one of the following token scopes: companies.","deprecated":null,"version":null,"openapi":"/openapi.json get /business/companies/autocomplete","href":"/api-reference/company-search/suggest-values-for-company-and-location-filters"},{"title":"Run a company search","deprecated":null,"version":null,"openapi":"/openapi.json post /business/companies/search","href":"/api-reference/company-search/run-a-company-search"},{"title":"Save company-search results into a list","description":"Run the search server-side and save up to `limit` matches into a company list. Same filter-source contract as POST /companies/search — exactly one of `filters`, `savedSearchId`, `savedSearchName` or `query`. The destination is exactly one of `listId` or `listName`; `listName` is create-or-reuse by exact name (case-insensitive), a name shared by two lists is a 409, and system list names are refused.\n\n`filters.headquartersCity` names are geocoded one by one and OR-ed together; a name that geocodes to nothing is dropped and the job runs on the rest — only when not one resolves is it refused with 422 CITY_FILTER_UNRESOLVED, and there is no upfront credit pre-check, so take the values from GET /companies/autocomplete?field=location. Firmographics land on the saved companies automatically — there is no `enrich` switch. Always async: 202 means the save started, not that the list is populated; poll the list's rows. Billing: the job saves in pages of 100 and debits 1 credit per company as it goes, so there is no upfront pre-check and a partially completed run is partially billed.\n\nErrors:\n- `404` `SAVED_SEARCH_NOT_FOUND` — No saved search of yours has that id or exact title.\n- `409` `SAVED_SEARCH_NAME_AMBIGUOUS` — Two of your saved searches share that title — reference it by `savedSearchId` instead.\n- `409` `LIST_NAME_AMBIGUOUS` — Two of your company lists share that name — pass `listId` instead.\n- `409` `LIST_NAME_TAKEN` — A company list with that name was created concurrently; retry with `listId`.\n- `422` `VALIDATION_FAILED` — The request failed the declared schema; `param` names the offending key and `message` quotes the rule it broke.\n- `422` `SAVED_SEARCH_TYPE_MISMATCH` — The saved search exists but stores the other kind of filters; `param` is `savedSearchId`.\n- `422` `SAVED_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 saved from a whole-universe search.\n- `422` `QUERY_FILTERS_INVALID` — The natural-language `query` produced no usable filter; name concrete criteria.\n- `422` `CITY_FILTER_UNRESOLVED` — NOT ONE of the `filters.headquartersCity` names geocoded to a city area, so the save was refused before it started; names that do geocode are OR-ed together and a name that does not is dropped, so this fires only when every name fails. `param` is `filters.headquartersCity`.\n- `422` `LIST_NAME_RESERVED` — `listName` is a system/dynamic list title and cannot be a destination.\n- `429` `RATE_LIMITED` — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.\n- `500` `UNEXPECTED_ERROR` — The request failed inside the service; nothing was billed and the request_id identifies the failure.\n\nRequires one of the following token scopes: companies.","deprecated":null,"version":null,"openapi":"/openapi.json post /business/companies/search/save-to-list","href":"/api-reference/company-search/save-company-search-results-into-a-list"}]},{"group":"Saved searches","pages":[{"title":"List the token owner's saved searches","deprecated":null,"version":null,"openapi":"/openapi.json get /business/saved-searches","href":"/api-reference/saved-searches/list-the-token-owners-saved-searches"},{"title":"Create a saved search","deprecated":null,"version":null,"openapi":"/openapi.json post /business/saved-searches","href":"/api-reference/saved-searches/create-a-saved-search"},{"title":"Get one saved search","deprecated":null,"version":null,"openapi":"/openapi.json get /business/saved-searches/{savedSearchId}","href":"/api-reference/saved-searches/get-one-saved-search"},{"title":"Delete a saved search","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/saved-searches/{savedSearchId}","href":"/api-reference/saved-searches/delete-a-saved-search"},{"title":"Rename a saved search or replace its filters","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/saved-searches/{savedSearchId}","href":"/api-reference/saved-searches/rename-a-saved-search-or-replace-its-filters"},{"title":"Replay a saved search","deprecated":null,"version":null,"openapi":"/openapi.json post /business/saved-searches/{savedSearchId}/run","href":"/api-reference/saved-searches/replay-a-saved-search"}]},{"group":"Folders","pages":[{"title":"List the token owner's list folders of one kind","deprecated":null,"version":null,"openapi":"/openapi.json get /business/folders","href":"/api-reference/folders/list-the-token-owners-list-folders-of-one-kind"},{"title":"Create a list folder","deprecated":null,"version":null,"openapi":"/openapi.json post /business/folders","href":"/api-reference/folders/create-a-list-folder"},{"title":"Delete a folder (its lists move to the root)","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/folders/{folderId}","href":"/api-reference/folders/delete-a-folder-its-lists-move-to-the-root"},{"title":"Rename a folder","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/folders/{folderId}","href":"/api-reference/folders/rename-a-folder"}]},{"group":"Contacts","pages":[{"title":"Resolve the caller's contact by LinkedIn URL","deprecated":null,"version":null,"openapi":"/openapi.json post /business/contacts/resolve","href":"/api-reference/contacts/resolve-the-callers-contact-by-linkedin-url"},{"title":"Set a contact's primary email and/or phone","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/contacts/{contactId}","href":"/api-reference/contacts/set-a-contacts-primary-email-andor-phone"},{"title":"A contact's activity timeline","deprecated":null,"version":null,"openapi":"/openapi.json get /business/contacts/{contactId}/activities","href":"/api-reference/contacts/a-contacts-activity-timeline"},{"title":"Start an async duplicate-contact scan (returns a jobId)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/contacts/dedupe-scan","href":"/api-reference/contacts/start-an-async-duplicate-contact-scan-returns-a-jobid"},{"title":"Merge the duplicate groups a completed scan found","deprecated":null,"version":null,"openapi":"/openapi.json post /business/contacts/dedupe-merge","href":"/api-reference/contacts/merge-the-duplicate-groups-a-completed-scan-found"},{"title":"Poll a dedupe scan or merge job (groups / totals when completed)","deprecated":null,"version":null,"openapi":"/openapi.json get /business/contacts/dedupe-jobs/{jobId}","href":"/api-reference/contacts/poll-a-dedupe-scan-or-merge-job-groups-totals-when-completed"}]}]}]},"basePath":"","title":"Run a company search - Fuse API","buildId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","deploymentId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CVpqyvFO.js","utils-vpweLD0v.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BIOodqb0.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B1LM3qmu.js","snippetPresets-C5xK0GtN.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CCsxLnQl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C2-WKG22.js","shallow-SdoLUC-q.js","getApiPlaygroundDisplay-BnI8L2hB.js","CodeSnippet-D5M8NCHI.js","CodeSnippets-CXRO8Uom.js","Page-CN9QbZiA.js","getPastedJson-CrfHEdRt.js","icon-Cr8AyUnW.js","MethodPill-J_Cs0kNw.js","DuplicateIcon-DrMboxGw.js","createIcon-B4CIWVbU.js","DynamicMarkdown-D9cdbgj9.js","SectionHeading-BO4CouT0.js","axios-vUo_bRtp.js","Markdown-L1m1-PSi.js","clsx-rIpTdK8h.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-ptfS1uB_.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D31Sm3f9.js"]}