Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed.
Send the filter source POST /companies/search takes, exactly one of: query, e.g. “Series B fintech companies in New York with 50 to 200 employees”; filters in the POST /companies/search vocabulary; or one of your company saved searches by savedSearchId or savedSearchName. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries status, total (the companies matching), filters (what was counted: send them to POST /companies/search to list the companies), unresolvedCriteria (parts of a query that could not be mapped to a filter, only with query) and creditsCharged (always 0).
The count runs in the background, usually for a few seconds: the first call answers 202 with statuspending, total null and the filters being counted. Repeat the request every few seconds with those filters (not the query, which would be converted again and could count a different search) until it answers 200 with statusready. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute.
Only keys whose usage plan includes company_count may call it. Rate limit: the plan’s company_count entry.
Errors:
403API_NOT_ON_PLAN — The key’s usage plan does not include company_count.
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.
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 search is empty, or every value in it was retired.
422QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages.
422SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take; param names the filter and values the refused entry. Take values from GET /companies/filter-options.
422CITY_FILTER_UNRESOLVED — Not one filters.headquartersCity name geocoded to a city, so the count was refused rather than run worldwide.
429RATE_LIMITED — The plan’s per-minute or per-day limit for company_count is spent.
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.
Only with query: the parts of the sentence no filter could express.
{"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.4021","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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}],"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/data/count-companies-matching-a-search-free","slug":"/api-reference/data/count-companies-matching-a-search-free","pageMetadata":{"title":"Count companies matching a search (free)","description":"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed.\n\nSend the filter source POST /companies/search takes, exactly one of: `query`, e.g. \"Series B fintech companies in New York with 50 to 200 employees\"; `filters` in the POST /companies/search vocabulary; or one of your company saved searches by `savedSearchId` or `savedSearchName`. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries `status`, `total` (the companies matching), `filters` (what was counted: send them to POST /companies/search to list the companies), `unresolvedCriteria` (parts of a `query` that could not be mapped to a filter, only with `query`) and `creditsCharged` (always 0).\n\nThe count runs in the background, usually for a few seconds: the first call answers 202 with `status` `pending`, `total` null and the `filters` being counted. Repeat the request every few seconds with those `filters` (not the `query`, which would be converted again and could count a different search) until it answers 200 with `status` `ready`. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute.\n\nOnly keys whose usage plan includes `company_count` may call it. Rate limit: the plan's `company_count` entry.\n\nErrors:\n- `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `company_count`.\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` `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 search is empty, or every value in it was retired.\n- `422` `QUERY_FILTERS_INVALID` — The `query` could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages.\n- `422` `SEARCH_FILTERS_INVALID` — A filter holds a value the search cannot take; `param` names the filter and `values` the refused entry. Take values from GET /companies/filter-options.\n- `422` `CITY_FILTER_UNRESOLVED` — Not one `filters.headquartersCity` name geocoded to a city, so the count was refused rather than run worldwide.\n- `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `company_count` is spent.\n\nRequires one of the following token scopes: data.","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/companies/count","href":"/api-reference/data/count-companies-matching-a-search-free","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: [_jsx(_components.p, {\n children: \"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Send the filter source POST /companies/search takes, exactly one of: \", _jsx(_components.code, {\n children: \"query\"\n }), \", e.g. “Series B fintech companies in New York with 50 to 200 employees”; \", _jsx(_components.code, {\n children: \"filters\"\n }), \" in the POST /companies/search vocabulary; or one of your company saved searches by \", _jsx(_components.code, {\n children: \"savedSearchId\"\n }), \" or \", _jsx(_components.code, {\n children: \"savedSearchName\"\n }), \". A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries \", _jsx(_components.code, {\n children: \"status\"\n }), \", \", _jsx(_components.code, {\n children: \"total\"\n }), \" (the companies matching), \", _jsx(_components.code, {\n children: \"filters\"\n }), \" (what was counted: send them to POST /companies/search to list the companies), \", _jsx(_components.code, {\n children: \"unresolvedCriteria\"\n }), \" (parts of a \", _jsx(_components.code, {\n children: \"query\"\n }), \" that could not be mapped to a filter, only with \", _jsx(_components.code, {\n children: \"query\"\n }), \") and \", _jsx(_components.code, {\n children: \"creditsCharged\"\n }), \" (always 0).\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The count runs in the background, usually for a few seconds: the first call answers 202 with \", _jsx(_components.code, {\n children: \"status\"\n }), \" \", _jsx(_components.code, {\n children: \"pending\"\n }), \", \", _jsx(_components.code, {\n children: \"total\"\n }), \" null and the \", _jsx(_components.code, {\n children: \"filters\"\n }), \" being counted. Repeat the request every few seconds with those \", _jsx(_components.code, {\n children: \"filters\"\n }), \" (not the \", _jsx(_components.code, {\n children: \"query\"\n }), \", which would be converted again and could count a different search) until it answers 200 with \", _jsx(_components.code, {\n children: \"status\"\n }), \" \", _jsx(_components.code, {\n children: \"ready\"\n }), \". A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Only keys whose usage plan includes \", _jsx(_components.code, {\n children: \"company_count\"\n }), \" may call it. Rate limit: the plan’s \", _jsx(_components.code, {\n children: \"company_count\"\n }), \" entry.\"]\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: \"403\"\n }), \" \", _jsx(_components.code, {\n children: \"API_NOT_ON_PLAN\"\n }), \" — The key’s usage plan does not include \", _jsx(_components.code, {\n children: \"company_count\"\n }), \".\"]\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: \"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 search is empty, or every value in it was retired.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"422\"\n }), \" \", _jsx(_components.code, {\n children: \"QUERY_FILTERS_INVALID\"\n }), \" — The \", _jsx(_components.code, {\n children: \"query\"\n }), \" could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages.\"]\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; \", _jsx(_components.code, {\n children: \"param\"\n }), \" names the filter and \", _jsx(_components.code, {\n children: \"values\"\n }), \" the refused entry. Take values from GET /companies/filter-options.\"]\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 \", _jsx(_components.code, {\n children: \"filters.headquartersCity\"\n }), \" name geocoded to a city, so the count was refused rather than run worldwide.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"429\"\n }), \" \", _jsx(_components.code, {\n children: \"RATE_LIMITED\"\n }), \" — The plan’s per-minute or per-day limit for \", _jsx(_components.code, {\n children: \"company_count\"\n }), \" is spent.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Requires one of the following token scopes: data.\"\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":"Count companies matching a search (free)","description":"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed.\n\nSend the filter source POST /companies/search takes, exactly one of: `query`, e.g. \"Series B fintech companies in New York with 50 to 200 employees\"; `filters` in the POST /companies/search vocabulary; or one of your company saved searches by `savedSearchId` or `savedSearchName`. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries `status`, `total` (the companies matching), `filters` (what was counted: send them to POST /companies/search to list the companies), `unresolvedCriteria` (parts of a `query` that could not be mapped to a filter, only with `query`) and `creditsCharged` (always 0).\n\nThe count runs in the background, usually for a few seconds: the first call answers 202 with `status` `pending`, `total` null and the `filters` being counted. Repeat the request every few seconds with those `filters` (not the `query`, which would be converted again and could count a different search) until it answers 200 with `status` `ready`. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute.\n\nOnly keys whose usage plan includes `company_count` may call it. Rate limit: the plan's `company_count` entry.\n\nErrors:\n- `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `company_count`.\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` `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 search is empty, or every value in it was retired.\n- `422` `QUERY_FILTERS_INVALID` — The `query` could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages.\n- `422` `SEARCH_FILTERS_INVALID` — A filter holds a value the search cannot take; `param` names the filter and `values` the refused entry. Take values from GET /companies/filter-options.\n- `422` `CITY_FILTER_UNRESOLVED` — Not one `filters.headquartersCity` name geocoded to a city, so the count was refused rather than run worldwide.\n- `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `company_count` is spent.\n\nRequires one of the following token scopes: data.","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/companies/count","href":"/api-reference/data/count-companies-matching-a-search-free","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"countCompanies","summary":"Count companies matching a search (free)","tags":["Data"],"security":["3a0fa49f-914c-4f33-b467-48977699bfc9"],"responses":{"200":"609a63f0-bef1-4519-940f-7364bf90a3f0","202":"482ffcc3-76a4-45ac-9153-cef0aed31331","400":"d0c2a131-9c45-4c91-91cb-2faa5943ec00","401":"b85aee9f-fadb-474e-8305-c57d226c0d1e","402":"16fd2e98-581e-4a38-9648-2d53074303f2","403":"a9732285-0f87-472b-ae9b-18ba2c8eb77a","404":"c2e781ee-a552-4ee2-8a45-4b990f2a06c2","409":"daa8fb63-d922-4dbb-8c83-89ec721e684f","422":"fb3cf7c7-cdb7-466f-99dd-33b47fbbb22b","429":"bb275d07-769d-4184-b50e-7cc62ecd4828","500":"cc979aea-9c8d-4751-8347-a154b05fcbfc"},"description":"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed.\n\nSend the filter source POST /companies/search takes, exactly one of: `query`, e.g. \"Series B fintech companies in New York with 50 to 200 employees\"; `filters` in the POST /companies/search vocabulary; or one of your company saved searches by `savedSearchId` or `savedSearchName`. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries `status`, `total` (the companies matching), `filters` (what was counted: send them to POST /companies/search to list the companies), `unresolvedCriteria` (parts of a `query` that could not be mapped to a filter, only with `query`) and `creditsCharged` (always 0).\n\nThe count runs in the background, usually for a few seconds: the first call answers 202 with `status` `pending`, `total` null and the `filters` being counted. Repeat the request every few seconds with those `filters` (not the `query`, which would be converted again and could count a different search) until it answers 200 with `status` `ready`. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute.\n\nOnly keys whose usage plan includes `company_count` may call it. Rate limit: the plan's `company_count` entry.\n\nErrors:\n- `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `company_count`.\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` `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 search is empty, or every value in it was retired.\n- `422` `QUERY_FILTERS_INVALID` — The `query` could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages.\n- `422` `SEARCH_FILTERS_INVALID` — A filter holds a value the search cannot take; `param` names the filter and `values` the refused entry. Take values from GET /companies/filter-options.\n- `422` `CITY_FILTER_UNRESOLVED` — Not one `filters.headquartersCity` name geocoded to a city, so the count was refused rather than run worldwide.\n- `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `company_count` is spent.\n\nRequires one of the following token scopes: data.","requestBody":"1e8098d2-f027-491f-b27b-96bf15f53867","method":"post","type":"path","servers":["4ca8b996-e74f-447c-8937-bc591ab08d00"],"path":"/business/data/companies/count","baseUrlOptions":["https://api.tryfuse.ai/api/v1"],"title":"Count companies matching a search (free)","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>"}]},"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"}},"description":"Exactly one filter source, as POST /companies/search takes it: `filters`, `savedSearchId`, `savedSearchName` or `query`. A count has no 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>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"609a63f0-bef1-4519-940f-7364bf90a3f0":{"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":["status","total","filters","creditsCharged"],"properties":{"status":{"type":"string","enum":["ready","pending"],"description":"`ready` (200) with the `total`, or `pending` (202) while the count runs: repeat the request.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"total":{"oneOf":[{"type":"integer","description":"Companies matching the filters; null while `pending`.","isRequired":true,"uniqueKey":"total.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Companies matching the filters; null while `pending`.","isRequired":true,"uniqueKey":"total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"total","typeLabel":"integer | null"},"filters":{"type":"object","additionalProperties":true,"description":"The filters counted, in the POST /companies/search vocabulary.","isRequired":true,"uniqueKey":"filters","typeLabel":"object"},"creditsCharged":{"type":"integer","description":"Always 0: counting is free.","isRequired":true,"uniqueKey":"creditsCharged","typeLabel":"integer"},"unresolvedCriteria":{"type":"array","items":{"type":"string","uniqueKey":"unresolvedCriteria.items.[INDEX]","typeLabel":"string"},"description":"Only with `query`: the parts of the sentence no filter could express.","uniqueKey":"unresolvedCriteria","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"status":"ready","total":1287,"filters":{"crunchbaseCategoryGroups":["Financial Services"],"stage":[{"label":"Series B","value":"series_b","status":"include"}],"headquartersCity":["New York"],"employeeCountV2":{"min":50,"max":200}},"unresolvedCriteria":[],"creditsCharged":0},"examples":{"Example":{"title":"Example","value":{"status":"ready","total":1287,"filters":{"crunchbaseCategoryGroups":["Financial Services"],"stage":[{"label":"Series B","value":"series_b","status":"include"}],"headquartersCity":["New York"],"employeeCountV2":{"min":50,"max":200}},"unresolvedCriteria":[],"creditsCharged":0}}},"exampleType":"examples"}},"exampleType":"examples"},"482ffcc3-76a4-45ac-9153-cef0aed31331":{"description":"The count is still running: repeat the request with the returned `filters` until it answers 200.","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","properties":{"status":{"type":"string","uniqueKey":"status","typeLabel":"string"},"total":{"oneOf":[{"type":"string","uniqueKey":"total.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"total.oneOf.1","typeLabel":"null"}],"uniqueKey":"total","typeLabel":"string | null"},"filters":{"type":"object","properties":{"crunchbaseCategoryGroups":{"type":"array","items":{"type":"string","uniqueKey":"filters.crunchbaseCategoryGroups.items.[INDEX]","typeLabel":"string"},"uniqueKey":"filters.crunchbaseCategoryGroups","typeLabel":"string[]"},"stage":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","uniqueKey":"filters.stage.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","uniqueKey":"filters.stage.items.[INDEX].value","typeLabel":"string"},"status":{"type":"string","uniqueKey":"filters.stage.items.[INDEX].status","typeLabel":"string"}},"uniqueKey":"filters.stage.items.[INDEX]","typeLabel":"object"},"uniqueKey":"filters.stage","typeLabel":"object[]"},"headquartersCity":{"type":"array","items":{"type":"string","uniqueKey":"filters.headquartersCity.items.[INDEX]","typeLabel":"string"},"uniqueKey":"filters.headquartersCity","typeLabel":"string[]"},"employeeCountV2":{"type":"object","properties":{"min":{"type":"integer","uniqueKey":"filters.employeeCountV2.min","typeLabel":"integer"},"max":{"type":"integer","uniqueKey":"filters.employeeCountV2.max","typeLabel":"integer"}},"uniqueKey":"filters.employeeCountV2","typeLabel":"object"}},"uniqueKey":"filters","typeLabel":"object"},"unresolvedCriteria":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"unresolvedCriteria.items.[INDEX]","typeLabel":"any"},"uniqueKey":"unresolvedCriteria","typeLabel":"any[]"},"creditsCharged":{"type":"integer","uniqueKey":"creditsCharged","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"status":"pending","total":null,"filters":{"crunchbaseCategoryGroups":["Financial Services"],"stage":[{"label":"Series B","value":"series_b","status":"include"}],"headquartersCity":["New York"],"employeeCountV2":{"min":50,"max":200}},"unresolvedCriteria":[],"creditsCharged":0},"examples":{"Example":{"title":"Example","value":{"status":"pending","total":null,"filters":{"crunchbaseCategoryGroups":["Financial Services"],"stage":[{"label":"Series B","value":"series_b","status":"include"}],"headquartersCity":["New York"],"employeeCountV2":{"min":50,"max":200}},"unresolvedCriteria":[],"creditsCharged":0}}},"exampleType":"examples"}},"exampleType":"examples"},"d0c2a131-9c45-4c91-91cb-2faa5943ec00":{"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"},"b85aee9f-fadb-474e-8305-c57d226c0d1e":{"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"},"16fd2e98-581e-4a38-9648-2d53074303f2":{"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"},"a9732285-0f87-472b-ae9b-18ba2c8eb77a":{"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"},"c2e781ee-a552-4ee2-8a45-4b990f2a06c2":{"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"},"daa8fb63-d922-4dbb-8c83-89ec721e684f":{"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"},"fb3cf7c7-cdb7-466f-99dd-33b47fbbb22b":{"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"},"bb275d07-769d-4184-b50e-7cc62ecd4828":{"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"},"cc979aea-9c8d-4751-8347-a154b05fcbfc":{"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":{"3a0fa49f-914c-4f33-b467-48977699bfc9":{"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":"Count companies matching a search (free) - Fuse API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T16:59:46.592Z","originalFileLocation":"api-reference/data/count-companies-matching-a-search-free.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=\"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed. Send the filter source POST /companies/search takes, exactly one of: query, e.g. \u0026quot;Series B fintech companies in New York with 50 to 200 employees\u0026quot;; filters in the POST /companies/search vocabulary; or one of your company saved searches by savedSearchId or savedSearchName. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries status, total (the companies matching), filters (what was counted: send them to POST /companies/search to list the companies), unresolvedCriteria (parts of a query that could not be mapped to a filter, only with query) and creditsCharged (always 0). The count runs in the background, usually for a few seconds: the first call answers 202 with status pending, total null and the filters being counted. Repeat the request every few seconds with those filters (not the query, which would be converted again and could count a different search) until it answers 200 with status ready. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute. Only keys whose usage plan includes company_count may call it. Rate limit: the plan\u0026#x27;s company_count entry. Errors: - 403 API_NOT_ON_PLAN — The key\u0026#x27;s usage plan does not include company_count. - 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 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 search is empty, or every value in it was retired. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take; param names the filter and values the refused entry. Take values from GET /companies/filter-options. - 422 CITY_FILTER_UNRESOLVED — Not one filters.headquartersCity name geocoded to a city, so the count was refused rather than run worldwide. - 429 RATE_LIMITED — The plan\u0026#x27;s per-minute or per-day limit for company_count is spent. Requires one of the following token scopes: data.\">\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=\"Count companies matching a search (free) - Fuse API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed. Send the filter source POST /companies/search takes, exactly one of: query, e.g. \u0026quot;Series B fintech companies in New York with 50 to 200 employees\u0026quot;; filters in the POST /companies/search vocabulary; or one of your company saved searches by savedSearchId or savedSearchName. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries status, total (the companies matching), filters (what was counted: send them to POST /companies/search to list the companies), unresolvedCriteria (parts of a query that could not be mapped to a filter, only with query) and creditsCharged (always 0). The count runs in the background, usually for a few seconds: the first call answers 202 with status pending, total null and the filters being counted. Repeat the request every few seconds with those filters (not the query, which would be converted again and could count a different search) until it answers 200 with status ready. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute. Only keys whose usage plan includes company_count may call it. Rate limit: the plan\u0026#x27;s company_count entry. Errors: - 403 API_NOT_ON_PLAN — The key\u0026#x27;s usage plan does not include company_count. - 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 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 search is empty, or every value in it was retired. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take; param names the filter and values the refused entry. Take values from GET /companies/filter-options. - 422 CITY_FILTER_UNRESOLVED — Not one filters.headquartersCity name geocoded to a city, so the count was refused rather than run worldwide. - 429 RATE_LIMITED — The plan\u0026#x27;s per-minute or per-day limit for company_count is spent. Requires one of the following token scopes: data.\">\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/data/count-companies-matching-a-search-free\">\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=Data\u0026amp;title=Count+companies+matching+a+search+%28free%29\u0026amp;description=Count+how+many+companies+match+a+plain-English+sentence%2C+a+saved+search+or+company-search+filters+%28industry%2C+headquarters+location%2C+headcount%2C+revenue%2C+funding+\u0026amp;theme=6edc0ab12d2194e24d86a864\u0026amp;signature=43b073985f599792c48fd0d0cf45f8d71035b906fa47c37d0f8c559ca9060472\">\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=\"Count companies matching a search (free) - Fuse API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed. Send the filter source POST /companies/search takes, exactly one of: query, e.g. \u0026quot;Series B fintech companies in New York with 50 to 200 employees\u0026quot;; filters in the POST /companies/search vocabulary; or one of your company saved searches by savedSearchId or savedSearchName. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries status, total (the companies matching), filters (what was counted: send them to POST /companies/search to list the companies), unresolvedCriteria (parts of a query that could not be mapped to a filter, only with query) and creditsCharged (always 0). The count runs in the background, usually for a few seconds: the first call answers 202 with status pending, total null and the filters being counted. Repeat the request every few seconds with those filters (not the query, which would be converted again and could count a different search) until it answers 200 with status ready. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute. Only keys whose usage plan includes company_count may call it. Rate limit: the plan\u0026#x27;s company_count entry. Errors: - 403 API_NOT_ON_PLAN — The key\u0026#x27;s usage plan does not include company_count. - 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 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 search is empty, or every value in it was retired. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take; param names the filter and values the refused entry. Take values from GET /companies/filter-options. - 422 CITY_FILTER_UNRESOLVED — Not one filters.headquartersCity name geocoded to a city, so the count was refused rather than run worldwide. - 429 RATE_LIMITED — The plan\u0026#x27;s per-minute or per-day limit for company_count is spent. Requires one of the following token scopes: data.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fuseai.mintlify.app/_mintlify/api/og/v2?division=Data\u0026amp;title=Count+companies+matching+a+search+%28free%29\u0026amp;description=Count+how+many+companies+match+a+plain-English+sentence%2C+a+saved+search+or+company-search+filters+%28industry%2C+headquarters+location%2C+headcount%2C+revenue%2C+funding+\u0026amp;theme=6edc0ab12d2194e24d86a864\u0026amp;signature=43b073985f599792c48fd0d0cf45f8d71035b906fa47c37d0f8c559ca9060472\">\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/data/count-companies-matching-a-search-free\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/data/count-companies-matching-a-search-free.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/data/count-companies-matching-a-search-free#webpage\",\"url\":\"https://docs.fuseai.com/api-reference/data/count-companies-matching-a-search-free\",\"name\":\"Count companies matching a search (free)\",\"description\":\"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed. Send the filter source POST /companies/search takes, exactly one of: query, e.g. \\\"Series B fintech companies in New York with 50 to 200 employees\\\"; filters in the POST /companies/search vocabulary; or one of your company saved searches by savedSearchId or savedSearchName. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries status, total (the companies matching), filters (what was counted: send them to POST /companies/search to list the companies), unresolvedCriteria (parts of a query that could not be mapped to a filter, only with query) and creditsCharged (always 0). The count runs in the background, usually for a few seconds: the first call answers 202 with status pending, total null and the filters being counted. Repeat the request every few seconds with those filters (not the query, which would be converted again and could count a different search) until it answers 200 with status ready. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute. Only keys whose usage plan includes company_count may call it. Rate limit: the plan's company_count entry. Errors: - 403 API_NOT_ON_PLAN — The key's usage plan does not include company_count. - 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 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 search is empty, or every value in it was retired. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take; param names the filter and values the refused entry. Take values from GET /companies/filter-options. - 422 CITY_FILTER_UNRESOLVED — Not one filters.headquartersCity name geocoded to a city, so the count was refused rather than run worldwide. - 429 RATE_LIMITED — The plan's per-minute or per-day limit for company_count is spent. Requires one of the following token scopes: data.\",\"dateModified\":\"2026-10-29T16:59:46.592Z\",\"isPartOf\":{\"@id\":\"https://docs.fuseai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fuseai.com/api-reference/data/count-companies-matching-a-search-free#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fuseai.com/api-reference/data/count-companies-matching-a-search-free#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Data\",\"item\":\"https://docs.fuseai.com/api-reference/data/get-your-keys-usage-plan\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Count companies matching a search (free)\",\"item\":\"https://docs.fuseai.com/api-reference/data/count-companies-matching-a-search-free\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fuseai.com/api-reference/data/count-companies-matching-a-search-free#apireference\",\"headline\":\"Count companies matching a search (free)\",\"name\":\"Count companies matching a search (free)\",\"description\":\"Count how many companies match a plain-English sentence, a saved search or company-search filters (industry, headquarters location, headcount, revenue, funding stage, technologies, keywords). Free: no credits are charged, and no companies are listed. Send the filter source POST /companies/search takes, exactly one of: query, e.g. \\\"Series B fintech companies in New York with 50 to 200 employees\\\"; filters in the POST /companies/search vocabulary; or one of your company saved searches by savedSearchId or savedSearchName. A count has no paging. Each source is resolved, refused and translated exactly as the search does it, so a count is of the companies that body would search. The answer carries status, total (the companies matching), filters (what was counted: send them to POST /companies/search to list the companies), unresolvedCriteria (parts of a query that could not be mapped to a filter, only with query) and creditsCharged (always 0). The count runs in the background, usually for a few seconds: the first call answers 202 with status pending, total null and the filters being counted. Repeat the request every few seconds with those filters (not the query, which would be converted again and could count a different search) until it answers 200 with status ready. A counted search stays cached for 15 minutes, so repeating it answers at once. A count the company data provider fails or is too busy for answers 503: retry in a minute. Only keys whose usage plan includes company_count may call it. Rate limit: the plan's company_count entry. Errors: - 403 API_NOT_ON_PLAN — The key's usage plan does not include company_count. - 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 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 search is empty, or every value in it was retired. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: industries, locations, sizes, funding stages. - 422 SEARCH_FILTERS_INVALID — A filter holds a value the search cannot take; param names the filter and values the refused entry. Take values from GET /companies/filter-options. - 422 CITY_FILTER_UNRESOLVED — Not one filters.headquartersCity name geocoded to a city, so the count was refused rather than run worldwide. - 429 RATE_LIMITED — The plan's per-minute or per-day limit for company_count is spent. Requires one of the following token scopes: data.\",\"url\":\"https://docs.fuseai.com/api-reference/data/count-companies-matching-a-search-free\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fuseai.com/api-reference/data/count-companies-matching-a-search-free#webpage\"},\"dateModified\":\"2026-10-29T16:59:46.592Z\",\"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)","description":"Count how many people match a plain-English sentence, a saved search or people-search filters (job title, seniority, department, employer, industry, location, headcount). Free: no credits are charged, and no names or contact details come back.\n\nSend the filter source POST /prospects/search takes, exactly one of: `query`, e.g. \"VPs of sales at fintech companies in New York\"; `filters` in the POST /prospects/search vocabulary; or one of your people saved searches by `savedSearchId` or `savedSearchName`. A count has no paging and no `linkedinUrl` lookup. Each source is resolved, and its filters translated and looked up, exactly as the search does it, so a count is of the people that body would search. The answer carries `status`, `total` (the people matching), `filters` (what was counted: send them to POST /prospects/search to list the people), `unresolvedCriteria` (parts of a `query` that could not be mapped to a filter, only with `query`), `closestCompanyMatches` (each company the `query` named that Smart Search chose between same-named companies for, only with `query`), `ignoredFilterKeys` (stored keys with no search field, only with a saved search) and `creditsCharged` (always 0).\n\nA new count runs in the background, for up to about a minute and a half: the first call answers 202 with `status` `pending`, `total` null and the `filters` being counted. Repeat the request every few seconds with those `filters` (not the `query`, which would be converted again and could count a different search) until it answers 200 with `status` `ready`. A counted search stays cached for 15 minutes, so repeating it answers at once. Each account starts at most 10 new counts a minute and 500 a day; past that, a new count answers 503 for a minute.\n\nOnly keys whose usage plan includes `people_count` may call it. Rate limit: the plan's `people_count` entry.\n\nErrors:\n- `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `people_count`.\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` `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 search: every value was retired, or nothing in them is a filter.\n- `422` `QUERY_FILTERS_INVALID` — The `query` could not be turned into filters. Name concrete criteria: titles, locations, industries, company sizes.\n- `422` `FILTER_VALUE_UNRESOLVED` — No company or place named in one filter could be found; `param` names the filter and `values` the values nothing matched.\n- `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `people_count` is spent, or too many `query` sentences were converted today.\n\nRequires one of the following token scopes: data.","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)","description":"Find a company's website domain, LinkedIn company page and logo from its name, website domain or LinkedIn URL. Free: no credits are charged.\n\nSend at least one of `name` (e.g. \"Stripe\"), `domain` (e.g. \"stripe.com\"; a full URL is reduced to its domain) or `linkedinUrl` (e.g. \"linkedin.com/company/stripe\"). When several are sent, only the most precise is looked up: `linkedinUrl`, then `domain`, then `name`. A name resolves to the best-known company of that name, so send a domain or LinkedIn page for common names.\n\nThe answer carries `status` (`found` or `not_found`), `company` (`name`, `domain`, `linkedinUrl` and `logoUrl`, each null when unknown; `company` itself is null when nothing matches) and `creditsCharged` (always 0). A company nothing matches is a 200 `not_found`, never a guess. A lookup the company data provider cannot answer in time answers 504 and caches nothing: retry. Next: pass the `domain` to POST /companies/search as `filters.domains` for the full company record.\n\nOnly keys whose usage plan includes `company_resolve` may call it. Rate limit: the plan's `company_resolve` entry.\n\nErrors:\n- `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `company_resolve`.\n- `422` `COMPANY_IDENTIFIER_INVALID` — `domain` is not a website domain, or `linkedinUrl` is not a LinkedIn company page.\n- `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `company_resolve` is spent, or the company data provider is busy: retry shortly.\n\nRequires one of the following token scopes: data.","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","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","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"}]}]}]},"title":"Count companies matching a search (free) - Fuse API","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}