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.
Send 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).
A new count runs in the background, for up to about a minute and a half: 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. Each account starts at most 10 new counts a minute and 500 a day; past that, a new count answers 503 for a minute.
Only keys whose usage plan includes people_count may call it. Rate limit: the plan’s people_count entry.
Errors:
403API_NOT_ON_PLAN — The key’s usage plan does not include people_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 search: every value was retired, or nothing in them is a filter.
422QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: titles, locations, industries, company sizes.
422FILTER_VALUE_UNRESOLVED — No company or place named in one filter could be found; param names the filter and values the values nothing matched.
429RATE_LIMITED — The plan’s per-minute or per-day limit for people_count is spent, or too many query sentences were converted today.
Your API token (af_…) as the Basic-auth username, with an empty password.
Body
application/json
Exactly one filter source, as POST /prospects/search takes it: filters, savedSearchId, savedSearchName or query. A count has no paging and no linkedinUrl lookup.
Literal filters, one of the four filter sources, in the vocabulary of POST /prospects/search. People filters in the search vocabulary: include/exclude fields take [{ status, value }] entries, term fields a string or an array of strings, rangeInputs{ min, max } ranges — every field and its accepted values are listed by GET /prospects/filter-options. On this endpoint a value outside a field's listed vocabulary is refused with 422 VALIDATION_FAILED, naming the field and the value, before anything is billed; so is a filter the search no longer serves (sex, github_url, github_username, facebook_url, job_title_sub_role, experience.title.sub_role, experience.company.industry, experience.company.location.country, experience.company.location.name, experience.company.location.continent, experience.company.type, location_continent, job_company_location_continent) and an exclude entry on education.degrees (the degree filter takes includes only; size and revenue excludes are searched). One exception: languages.name also accepts these other names of listed languages, searched as the listed one: bangla, farsi, panjabi, slovene, chinese, mandarin, putonghua, tagalog, filipino, sinhala, khmer, central khmer, hakka chinese, hokkien, taiwanese, newari, northern frisian, western frisian, ndebele, north ndebele, south ndebele, assyrian neo-aramaic. Must contain at least one non-empty value.
Exact title of one of your people 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 who 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: each company the sentence named that Smart Search chose between same-named companies for, and the one it chose; empty when it guessed nothing.
Only with a saved search: stored keys with no search field, left out of the count.
{"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-people-matching-a-search-free","slug":"/api-reference/data/count-people-matching-a-search-free","pageMetadata":{"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","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 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 }), \"\\n\", _jsxs(_components.p, {\n children: [\"Send the filter source POST /prospects/search takes, exactly one of: \", _jsx(_components.code, {\n children: \"query\"\n }), \", e.g. “VPs of sales at fintech companies in New York”; \", _jsx(_components.code, {\n children: \"filters\"\n }), \" in the POST /prospects/search vocabulary; or one of your people saved searches by \", _jsx(_components.code, {\n children: \"savedSearchId\"\n }), \" or \", _jsx(_components.code, {\n children: \"savedSearchName\"\n }), \". A count has no paging and no \", _jsx(_components.code, {\n children: \"linkedinUrl\"\n }), \" 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 \", _jsx(_components.code, {\n children: \"status\"\n }), \", \", _jsx(_components.code, {\n children: \"total\"\n }), \" (the people matching), \", _jsx(_components.code, {\n children: \"filters\"\n }), \" (what was counted: send them to POST /prospects/search to list the people), \", _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 }), \"), \", _jsx(_components.code, {\n children: \"closestCompanyMatches\"\n }), \" (each company the \", _jsx(_components.code, {\n children: \"query\"\n }), \" named that Smart Search chose between same-named companies for, only with \", _jsx(_components.code, {\n children: \"query\"\n }), \"), \", _jsx(_components.code, {\n children: \"ignoredFilterKeys\"\n }), \" (stored keys with no search field, only with a saved search) and \", _jsx(_components.code, {\n children: \"creditsCharged\"\n }), \" (always 0).\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A new count runs in the background, for up to about a minute and a half: 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. 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 }), \"\\n\", _jsxs(_components.p, {\n children: [\"Only keys whose usage plan includes \", _jsx(_components.code, {\n children: \"people_count\"\n }), \" may call it. Rate limit: the plan’s \", _jsx(_components.code, {\n children: \"people_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: \"people_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 search: every value was retired, or nothing in them is a filter.\"]\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: titles, locations, industries, company sizes.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"422\"\n }), \" \", _jsx(_components.code, {\n children: \"FILTER_VALUE_UNRESOLVED\"\n }), \" — No company or place named in one filter could be found; \", _jsx(_components.code, {\n children: \"param\"\n }), \" names the filter and \", _jsx(_components.code, {\n children: \"values\"\n }), \" the values nothing matched.\"]\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: \"people_count\"\n }), \" is spent, or too many \", _jsx(_components.code, {\n children: \"query\"\n }), \" sentences were converted today.\"]\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 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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"countPeople","summary":"Count people matching a search (free)","tags":["Data"],"security":["4b461194-7e20-43e2-8f87-a337d671ede5"],"responses":{"200":"15f4537a-c4be-4bbc-84ca-2803cabaaa5a","202":"61ca707a-11b5-404a-a1a7-230f825e4dbf","400":"31a65316-7ea5-47ca-8595-6a73f6d59abc","401":"e9893fe3-7c9c-465f-963e-bbcae41935ad","402":"0a50b2d1-5c3e-4e87-b031-6573ec62059b","403":"f0994ea3-52b5-44f8-a8bf-2a54d409d408","404":"350fd2e1-326d-4073-89c3-7f2f07f0f395","409":"79daff38-1d77-4bdc-821e-98c2893fbac6","422":"1b0ff321-a3ba-4d46-9121-71ddcef02a67","429":"e1af0444-ee26-4846-a1f3-c1ed6e5d1760","500":"4c30e952-d39b-449f-b776-5c7e3dd5c281"},"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.","requestBody":"98b0acf7-4148-4def-a2fa-ef69b8e08134","method":"post","type":"path","servers":["4ca8b996-e74f-447c-8937-bc591ab08d00"],"path":"/business/data/people/count","baseUrlOptions":["https://api.tryfuse.ai/api/v1"],"title":"Count people matching a search (free)","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.filters.industry.oneOf.0":"\u003cstring>","body.filters.job_title_levels.oneOf.0":"\u003cstring>","body.filters.job_title_role.oneOf.0":"\u003cstring>","body.filters.job_company_size.oneOf.0":"\u003cstring>","body.filters.job_company_inferred_revenue.oneOf.0":"\u003cstring>","body.filters.job_company_industry.oneOf.0":"\u003cstring>","body.filters.job_company_location_country.oneOf.0":"\u003cstring>","body.filters.job_company_location_region.oneOf.0":"\u003cstring>","body.filters.experience\\.title\\.levels.oneOf.0":"\u003cstring>","body.filters.experience\\.title\\.role.oneOf.0":"\u003cstring>","body.filters.languages\\.name.oneOf.0":"\u003cstring>","body.filters.location_country.oneOf.0":"\u003cstring>","body.filters.location_region.oneOf.0":"\u003cstring>","body.filters.education\\.degrees.oneOf.0":"\u003cstring>","body.filters.job_company_name.oneOf.0":"\u003cstring>","body.filters.job_company_website.oneOf.0":"\u003cstring>","body.filters.linkedin_url.oneOf.0":"\u003cstring>","body.filters.experience\\.company\\.name.oneOf.0":"\u003cstring>","body.filters.full_name.oneOf.0":"\u003cstring>","body.filters.first_name.oneOf.0":"\u003cstring>","body.filters.last_name.oneOf.0":"\u003cstring>","body.filters.work_email.oneOf.0":"\u003cstring>","body.filters.personal_emails.oneOf.0":"\u003cstring>","body.filters.mobile_phone.oneOf.0":"\u003cstring>","body.filters.job_title.oneOf.0":"\u003cstring>","body.filters.job_company_location_name.oneOf.0":"\u003cstring>","body.filters.location_name.oneOf.0":"\u003cstring>","body.filters.education\\.school\\.name.oneOf.0":"\u003cstring>","body.filters.experience\\.title\\.name.oneOf.0":"\u003cstring>","body.filters.experience\\.company\\.website.oneOf.0":"\u003cstring>","body.filters.job_start_date.oneOf.0":"\u003cstring>","body.filters.skills.oneOf.0":"\u003cstring>","body.filters.certifications\\.name.oneOf.0":"\u003cstring>","body.filters.keywords.items.0":"\u003cstring>","body.filters.excludedKeywords.items.0":"\u003cstring>","body.filters.rangeInputs.job_company_employee_count.min":123,"body.filters.rangeInputs.job_company_employee_count.max":123,"body.filters.rangeInputs.inferred_years_experience.min":123,"body.filters.rangeInputs.inferred_years_experience.max":123,"body.filters.rangeInputs.job_company_total_funding_raised.min":123,"body.filters.rangeInputs.job_company_total_funding_raised.max":123,"body.filters.company_filters.status.items.0.label":"\u003cstring>","body.filters.company_filters.tags.items.0.label":"\u003cstring>","body.filters.company_filters.acceleratorsV2.items.0.value":"\u003cstring>","body.filters.company_filters.acceleratorsV2.items.0.label":"\u003cstring>","body.filters.company_filters.stage.items.0.label":"\u003cstring>","body.filters.company_filters.investors.items.0.value":"\u003cstring>","body.filters.company_filters.investors.items.0.label":"\u003cstring>","body.filters.company_filters.technologies.items.0.value":"\u003cstring>","body.filters.company_filters.technologies.items.0.label":"\u003cstring>","body.filters.company_filters.industriesV2.items.0.value":"\u003cstring>","body.filters.company_filters.industriesV2.items.0.label":"\u003cstring>","body.filters.company_filters.linkedinIndustries.items.0.value":"\u003cstring>","body.filters.company_filters.linkedinIndustries.items.0.label":"\u003cstring>","body.filters.company_filters.crunchbaseCategories.items.0.value":"\u003cstring>","body.filters.company_filters.crunchbaseCategories.items.0.label":"\u003cstring>","body.filters.company_filters.naicsCodes.items.0.value":"\u003cstring>","body.filters.company_filters.naicsCodes.items.0.label":"\u003cstring>","body.filters.company_filters.officeLocationsV2.items.0.value":"\u003cstring>","body.filters.company_filters.officeLocationsV2.items.0.label":"\u003cstring>","body.filters.company_filters.fortuneRankings.items.0.label":"\u003cstring>","body.filters.company_filters.fortuneRankings.items.0.status":"include","body.filters.company_filters.keywords.items.0":"\u003cstring>","body.filters.company_filters.crunchbaseCategoryGroups.items.0":"\u003cstring>","body.filters.company_filters.linkedinSlugs.items.0":"\u003cstring>","body.filters.company_filters.lastFundingUSD.min":123,"body.filters.company_filters.lastFundingUSD.max":123,"body.filters.company_filters.foundedOn.start":"\u003cstring>","body.filters.company_filters.foundedOn.end":"\u003cstring>","body.filters.company_filters.lastFundedOn.start":"\u003cstring>","body.filters.company_filters.lastFundedOn.end":"\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":{"industry":{"oneOf":[{"type":"string","description":"Industry of the person themselves; include/exclude entries whose `value` is one of the 147 `industry` values from GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. financial services). Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.industry.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.industry.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.industry.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.industry.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.industry.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.industry.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.industry.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.industry.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.industry.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Industry of the person themselves; include/exclude entries whose `value` is one of the 147 `industry` values from GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. financial services). Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.industry.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.industry","typeLabel":"string | (string | object)[]"},"job_title_levels":{"oneOf":[{"type":"string","description":"Seniority of the current job title; entries with `value` one of exactly: cxo, vp, director, manager, senior, entry, owner, partner, training, unpaid (the `job_title_levels` list in GET /prospects/filter-options (the get_people_search_filter_options tool)). Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.job_title_levels.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_title_levels.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_title_levels.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_title_levels.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_title_levels.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_title_levels.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_title_levels.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_title_levels.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_title_levels.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Seniority of the current job title; entries with `value` one of exactly: cxo, vp, director, manager, senior, entry, owner, partner, training, unpaid (the `job_title_levels` list in GET /prospects/filter-options (the get_people_search_filter_options tool)). Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.job_title_levels.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_title_levels","typeLabel":"string | (string | object)[]"},"job_title_role":{"oneOf":[{"type":"string","description":"Department of the current job title; entries with `value` one of the 24 `job_title_role` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. engineering, sales, finance); `jobTitleRoleToSubRole` on GET /business/prospects/filter-options lists each role's sub-roles, which are no longer a filter. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.job_title_role.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_title_role.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_title_role.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_title_role.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_title_role.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_title_role.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_title_role.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_title_role.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_title_role.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Department of the current job title; entries with `value` one of the 24 `job_title_role` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. engineering, sales, finance); `jobTitleRoleToSubRole` on GET /business/prospects/filter-options lists each role's sub-roles, which are no longer a filter. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.job_title_role.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_title_role","typeLabel":"string | (string | object)[]"},"job_company_size":{"oneOf":[{"type":"string","description":"Headcount bracket of the current employer; entries with `value` one of exactly: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ — brackets only, so use `rangeInputs.job_company_employee_count` for an arbitrary headcount range. Each bracket is searched as its own band: include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.job_company_size.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_company_size.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_company_size.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_company_size.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_company_size.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_company_size.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_company_size.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_company_size.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_company_size.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Headcount bracket of the current employer; entries with `value` one of exactly: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ — brackets only, so use `rangeInputs.job_company_employee_count` for an arbitrary headcount range. Each bracket is searched as its own band: include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.job_company_size.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_company_size","typeLabel":"string | (string | object)[]"},"job_company_inferred_revenue":{"oneOf":[{"type":"string","description":"Inferred annual revenue bracket of the current employer; entries with `value` one of exactly: $0-$1m, $1m-$10m, $10m-$25m, $25m-$50m, $50m-$100m, $100m-$250m, $250m-$500m, $500m-$1b, $1b-$10b, $10b+ (matched case-insensitively, so $1M-$10M also works). Each bracket is searched as its own band: include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.job_company_inferred_revenue.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_company_inferred_revenue.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_company_inferred_revenue.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_company_inferred_revenue.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_company_inferred_revenue.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_company_inferred_revenue.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_company_inferred_revenue.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_company_inferred_revenue.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_company_inferred_revenue.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Inferred annual revenue bracket of the current employer; entries with `value` one of exactly: $0-$1m, $1m-$10m, $10m-$25m, $25m-$50m, $50m-$100m, $100m-$250m, $250m-$500m, $500m-$1b, $1b-$10b, $10b+ (matched case-insensitively, so $1M-$10M also works). Each bracket is searched as its own band: include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.job_company_inferred_revenue.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_company_inferred_revenue","typeLabel":"string | (string | object)[]"},"job_company_industry":{"oneOf":[{"type":"string","description":"Industry of the current employer; entries with `value` one of the same 147 industry values, listed under `job_company_industry` in GET /prospects/filter-options (the get_people_search_filter_options tool). Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.job_company_industry.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_company_industry.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_company_industry.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_company_industry.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_company_industry.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_company_industry.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_company_industry.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_company_industry.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_company_industry.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Industry of the current employer; entries with `value` one of the same 147 industry values, listed under `job_company_industry` in GET /prospects/filter-options (the get_people_search_filter_options tool). Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.job_company_industry.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_company_industry","typeLabel":"string | (string | object)[]"},"job_company_location_country":{"oneOf":[{"type":"string","description":"Country of the current employer's headquarters; entries with a lower-case `value` from the 249 `job_company_location_country` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. united states, germany) — country NAMES, never ISO codes. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.job_company_location_country.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_company_location_country.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_company_location_country.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_company_location_country.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_company_location_country.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_company_location_country.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_company_location_country.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_company_location_country.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_company_location_country.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Country of the current employer's headquarters; entries with a lower-case `value` from the 249 `job_company_location_country` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. united states, germany) — country NAMES, never ISO codes. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.job_company_location_country.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_company_location_country","typeLabel":"string | (string | object)[]"},"job_company_location_region":{"oneOf":[{"type":"string","description":"Region or state of the current employer's headquarters; entries with a free-text lower-case `value` such as california — resolve names with GET /prospects/autocomplete?field=region. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.job_company_location_region.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_company_location_region.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_company_location_region.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_company_location_region.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_company_location_region.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_company_location_region.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_company_location_region.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_company_location_region.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_company_location_region.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Region or state of the current employer's headquarters; entries with a free-text lower-case `value` such as california — resolve names with GET /prospects/autocomplete?field=region. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.job_company_location_region.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_company_location_region","typeLabel":"string | (string | object)[]"},"experience.title.levels":{"oneOf":[{"type":"string","description":"Seniority held in a PAST job (the current job does not count), matched on the past job's title words; entries with `value` one of exactly: cxo, vp, director, manager, senior, entry, owner, partner, training, unpaid. Next to `experience.title.role` both must hold in the same past job. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.experience\\.title\\.levels.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.experience\\.title\\.levels.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.experience\\.title\\.levels.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.experience\\.title\\.levels.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.experience\\.title\\.levels.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.experience\\.title\\.levels.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.experience\\.title\\.levels.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.experience\\.title\\.levels.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.experience\\.title\\.levels.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Seniority held in a PAST job (the current job does not count), matched on the past job's title words; entries with `value` one of exactly: cxo, vp, director, manager, senior, entry, owner, partner, training, unpaid. Next to `experience.title.role` both must hold in the same past job. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.experience\\.title\\.levels.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.experience\\.title\\.levels","typeLabel":"string | (string | object)[]"},"experience.title.role":{"oneOf":[{"type":"string","description":"Department of a PAST job (the current job does not count), matched on the past job's title words; entries with `value` one of the 24 `experience.title.role` values in GET /prospects/filter-options (the get_people_search_filter_options tool) — the same list as `job_title_role`. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.experience\\.title\\.role.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.experience\\.title\\.role.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.experience\\.title\\.role.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.experience\\.title\\.role.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.experience\\.title\\.role.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.experience\\.title\\.role.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.experience\\.title\\.role.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.experience\\.title\\.role.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.experience\\.title\\.role.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Department of a PAST job (the current job does not count), matched on the past job's title words; entries with `value` one of the 24 `experience.title.role` values in GET /prospects/filter-options (the get_people_search_filter_options tool) — the same list as `job_title_role`. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.experience\\.title\\.role.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.experience\\.title\\.role","typeLabel":"string | (string | object)[]"},"languages.name":{"oneOf":[{"type":"string","description":"Languages the person lists; entries with a lower-case `value` from the 187 `languages.name` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. english, german) — language NAMES, never ISO codes. Common other names are read as the listed language: farsi as persian, bangla as bengali, panjabi as punjabi, slovene as slovenian, chinese and mandarin as putonghua (Mandarin), tagalog and filipino as Tagalog/Filipino. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.languages\\.name.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.languages\\.name.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.languages\\.name.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.languages\\.name.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.languages\\.name.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.languages\\.name.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.languages\\.name.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.languages\\.name.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.languages\\.name.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Languages the person lists; entries with a lower-case `value` from the 187 `languages.name` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. english, german) — language NAMES, never ISO codes. Common other names are read as the listed language: farsi as persian, bangla as bengali, panjabi as punjabi, slovene as slovenian, chinese and mandarin as putonghua (Mandarin), tagalog and filipino as Tagalog/Filipino. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.languages\\.name.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.languages\\.name","typeLabel":"string | (string | object)[]"},"location_country":{"oneOf":[{"type":"string","description":"Country the person lives in; entries with a lower-case `value` from the 249 `location_country` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. united states, united kingdom) — country NAMES, never ISO codes. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.location_country.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.location_country.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.location_country.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.location_country.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.location_country.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.location_country.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.location_country.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.location_country.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.location_country.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Country the person lives in; entries with a lower-case `value` from the 249 `location_country` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. united states, united kingdom) — country NAMES, never ISO codes. Include values are OR-joined and every exclude applies; at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.location_country.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.location_country","typeLabel":"string | (string | object)[]"},"location_region":{"oneOf":[{"type":"string","description":"Region or state the person lives in; entries with a free-text lower-case `value` such as california — resolve names with GET /prospects/autocomplete?field=region. A region outside the United States is matched through a table of each country's regions; one the table does not hold is only searched next to a single `location_country`, and otherwise answers 422 FILTER_VALUE_UNRESOLVED. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.location_region.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.location_region.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.location_region.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.location_region.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.location_region.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.location_region.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.location_region.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.location_region.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.location_region.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Region or state the person lives in; entries with a free-text lower-case `value` such as california — resolve names with GET /prospects/autocomplete?field=region. A region outside the United States is matched through a table of each country's regions; one the table does not hold is only searched next to a single `location_country`, and otherwise answers 422 FILTER_VALUE_UNRESOLVED. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.location_region.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.location_region","typeLabel":"string | (string | object)[]"},"education.degrees":{"oneOf":[{"type":"string","description":"Degrees held; entries with `value` one of the 171 `education.degrees` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. bachelors, masters, master of business administration). Include values are OR-joined; include only, so an exclude entry is dropped (the Business API refuses it with 422 VALIDATION_FAILED); at most 1000 entries. A bare string or an array of strings are includes.","maxLength":500,"uniqueKey":"filters.education\\.degrees.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.education\\.degrees.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.education\\.degrees.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.education\\.degrees.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.education\\.degrees.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.education\\.degrees.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.education\\.degrees.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.education\\.degrees.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.education\\.degrees.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Degrees held; entries with `value` one of the 171 `education.degrees` values in GET /prospects/filter-options (the get_people_search_filter_options tool) (e.g. bachelors, masters, master of business administration). Include values are OR-joined; include only, so an exclude entry is dropped (the Business API refuses it with 422 VALIDATION_FAILED); at most 1000 entries. A bare string or an array of strings are includes.","maxItems":1000,"uniqueKey":"filters.education\\.degrees.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.education\\.degrees","typeLabel":"string | (string | object)[]"},"job_company_name":{"oneOf":[{"type":"string","description":"The current employer, matched by the company itself: send entries `{ status, value, liOrgId?, domain? }` where `value` is the company name and `liOrgId` (its LinkedIn organization id) or `domain` identify it. An entry with only a name matches every company with exactly that name. A bare string or an array of strings are includes by name. A field none of whose companies can be identified answers 422 FILTER_VALUE_UNRESOLVED; unidentified ones next to identified ones are dropped.","maxLength":500,"uniqueKey":"filters.job_company_name.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_company_name.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_company_name.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_company_name.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_company_name.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_company_name.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_company_name.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_company_name.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_company_name.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"The current employer, matched by the company itself: send entries `{ status, value, liOrgId?, domain? }` where `value` is the company name and `liOrgId` (its LinkedIn organization id) or `domain` identify it. An entry with only a name matches every company with exactly that name. A bare string or an array of strings are includes by name. A field none of whose companies can be identified answers 422 FILTER_VALUE_UNRESOLVED; unidentified ones next to identified ones are dropped.","maxItems":1000,"uniqueKey":"filters.job_company_name.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_company_name","typeLabel":"string | (string | object)[]"},"job_company_website":{"oneOf":[{"type":"string","description":"Website domain of the current employer (e.g. stripe.com — scheme, www and trailing slash are stripped); same value shapes as `job_company_name`; resolve with GET /prospects/autocomplete?field=website.","maxLength":500,"uniqueKey":"filters.job_company_website.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.job_company_website.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.job_company_website.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.job_company_website.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.job_company_website.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.job_company_website.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.job_company_website.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.job_company_website.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.job_company_website.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"Website domain of the current employer (e.g. stripe.com — scheme, www and trailing slash are stripped); same value shapes as `job_company_name`; resolve with GET /prospects/autocomplete?field=website.","maxItems":1000,"uniqueKey":"filters.job_company_website.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.job_company_website","typeLabel":"string | (string | object)[]"},"linkedin_url":{"oneOf":[{"type":"string","description":"A LinkedIn profile, matched by its profile slug (older slugs of the same person match too): a profile URL in any form (scheme, www. or a country subdomain, a trailing slash or query string and letter case are ignored), `in/\u003cslug>` or the bare slug. A string, an array of profiles that are OR-joined, or include/exclude entries ({ status, value }); every exclude applies, at most 1000 entries. Includes none of which names a profile answer 422 FILTER_VALUE_UNRESOLVED.","maxLength":500,"uniqueKey":"filters.linkedin_url.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"filters.linkedin_url.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["status","value"],"properties":{"status":{"type":"string","enum":["include","exclude"],"description":"`include` matches the value; `exclude` removes profiles carrying it (includes OR together, every exclude applies).","isRequired":true,"uniqueKey":"filters.linkedin_url.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.linkedin_url.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.linkedin_url.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.linkedin_url.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.linkedin_url.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.linkedin_url.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.linkedin_url.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"A LinkedIn profile, matched by its profile slug (older slugs of the same person match too): a profile URL in any form (scheme, www. or a country subdomain, a trailing slash or query string and letter case are ignored), `in/\u003cslug>` or the bare slug. A string, an array of profiles that are OR-joined, or include/exclude entries ({ status, value }); every exclude applies, at most 1000 entries. Includes none of which names a profile answer 422 FILTER_VALUE_UNRESOLVED.","maxItems":1000,"uniqueKey":"filters.linkedin_url.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.linkedin_url","typeLabel":"string | (string | object)[]"},"experience.company.name":{"oneOf":[{"type":"string","description":"A PAST employer, matched by the company itself the same way as `job_company_name` (`{ status: include, value, liOrgId?, domain? }` entries, or names as a string or an array). Include only.","maxLength":500,"minLength":1,"uniqueKey":"filters.experience\\.company\\.name.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":500,"minLength":1,"uniqueKey":"filters.experience\\.company\\.name.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["value","status"],"properties":{"value":{"type":"string","maxLength":500,"description":"The filter value (max 500 chars); for enum-backed fields use a value GET /prospects/filter-options (the get_people_search_filter_options tool) lists for the field — other values match nothing.","isRequired":true,"uniqueKey":"filters.experience\\.company\\.name.oneOf.1.items.[INDEX].oneOf.1.value","typeLabel":"string"},"status":{"type":"string","enum":["include"],"isRequired":true,"uniqueKey":"filters.experience\\.company\\.name.oneOf.1.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"label":{"type":"string","maxLength":500,"description":"Optional display label as returned by GET /prospects/filter-options (the get_people_search_filter_options tool); accepted and ignored.","uniqueKey":"filters.experience\\.company\\.name.oneOf.1.items.[INDEX].oneOf.1.label","typeLabel":"string"},"liOrgId":{"type":"string","minLength":1,"maxLength":32,"description":"Company filters only: the company's LinkedIn organization id, as the company typeahead returns it.","uniqueKey":"filters.experience\\.company\\.name.oneOf.1.items.[INDEX].oneOf.1.liOrgId","typeLabel":"string"},"domain":{"type":"string","minLength":1,"maxLength":500,"description":"Company filters only: the company's website domain (e.g. stripe.com).","uniqueKey":"filters.experience\\.company\\.name.oneOf.1.items.[INDEX].oneOf.1.domain","typeLabel":"string"}},"uniqueKey":"filters.experience\\.company\\.name.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"filters.experience\\.company\\.name.oneOf.1.items.[INDEX]","typeLabel":"string | object"},"description":"A PAST employer, matched by the company itself the same way as `job_company_name` (`{ status: include, value, liOrgId?, domain? }` entries, or names as a string or an array). Include only.","maxItems":1000,"uniqueKey":"filters.experience\\.company\\.name.oneOf.1","typeLabel":"(string | object)[]"}],"uniqueKey":"filters.experience\\.company\\.name","typeLabel":"string | (string | object)[]"},"full_name":{"oneOf":[{"type":"string","description":"Free text, matched FUZZILY against the person's name (e.g. Ada Nwosu also finds close spellings), in any case. A string, or an array of names that are OR-joined.","uniqueKey":"filters.full_name.oneOf.0","typeLabel":"string"},{"type":"number","description":"Free text, matched FUZZILY against the person's name (e.g. Ada Nwosu also finds close spellings), in any case. A string, or an array of names that are OR-joined.","uniqueKey":"filters.full_name.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Free text, matched FUZZILY against the person's name (e.g. Ada Nwosu also finds close spellings), in any case. A string, or an array of names that are OR-joined.","uniqueKey":"filters.full_name.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.full_name.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Free text, matched FUZZILY against the person's name (e.g. Ada Nwosu also finds close spellings), in any case. A string, or an array of names that are OR-joined.","uniqueKey":"filters.full_name.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.full_name","typeLabel":"string | number | boolean | string[]"},"first_name":{"oneOf":[{"type":"string","description":"Free text, matched fuzzily; sent next to `last_name` the two are matched as one full name. A string, or an array of names that are OR-joined. Cannot be stored in a saved search (422 SAVED_SEARCH_FILTERS_UNSUPPORTED).","uniqueKey":"filters.first_name.oneOf.0","typeLabel":"string"},{"type":"number","description":"Free text, matched fuzzily; sent next to `last_name` the two are matched as one full name. A string, or an array of names that are OR-joined. Cannot be stored in a saved search (422 SAVED_SEARCH_FILTERS_UNSUPPORTED).","uniqueKey":"filters.first_name.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Free text, matched fuzzily; sent next to `last_name` the two are matched as one full name. A string, or an array of names that are OR-joined. Cannot be stored in a saved search (422 SAVED_SEARCH_FILTERS_UNSUPPORTED).","uniqueKey":"filters.first_name.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.first_name.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Free text, matched fuzzily; sent next to `last_name` the two are matched as one full name. A string, or an array of names that are OR-joined. Cannot be stored in a saved search (422 SAVED_SEARCH_FILTERS_UNSUPPORTED).","uniqueKey":"filters.first_name.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.first_name","typeLabel":"string | number | boolean | string[]"},"last_name":{"oneOf":[{"type":"string","description":"Free text, matched fuzzily; sent next to `first_name` the two are matched as one full name. A string, or an array of names that are OR-joined. Cannot be stored in a saved search (422 SAVED_SEARCH_FILTERS_UNSUPPORTED).","uniqueKey":"filters.last_name.oneOf.0","typeLabel":"string"},{"type":"number","description":"Free text, matched fuzzily; sent next to `first_name` the two are matched as one full name. A string, or an array of names that are OR-joined. Cannot be stored in a saved search (422 SAVED_SEARCH_FILTERS_UNSUPPORTED).","uniqueKey":"filters.last_name.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Free text, matched fuzzily; sent next to `first_name` the two are matched as one full name. A string, or an array of names that are OR-joined. Cannot be stored in a saved search (422 SAVED_SEARCH_FILTERS_UNSUPPORTED).","uniqueKey":"filters.last_name.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.last_name.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Free text, matched fuzzily; sent next to `first_name` the two are matched as one full name. A string, or an array of names that are OR-joined. Cannot be stored in a saved search (422 SAVED_SEARCH_FILTERS_UNSUPPORTED).","uniqueKey":"filters.last_name.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.last_name","typeLabel":"string | number | boolean | string[]"},"work_email":{"oneOf":[{"type":"string","description":"An email address: the provider's best match for it is looked up, then searched with every other filter. A string, or an array of up to 10 addresses that are OR-joined; when none of them finds anyone the search gives no rows and bills nothing. Work and personal addresses are looked up alike (`personal_emails` works the same way); sent with `personal_emails` or `mobile_phone`, the person must have all of them. A field none of whose values is an email address answers 422 FILTER_VALUE_UNRESOLVED.","maxLength":254,"minLength":1,"uniqueKey":"filters.work_email.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":254,"uniqueKey":"filters.work_email.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"An email address: the provider's best match for it is looked up, then searched with every other filter. A string, or an array of up to 10 addresses that are OR-joined; when none of them finds anyone the search gives no rows and bills nothing. Work and personal addresses are looked up alike (`personal_emails` works the same way); sent with `personal_emails` or `mobile_phone`, the person must have all of them. A field none of whose values is an email address answers 422 FILTER_VALUE_UNRESOLVED.","maxItems":10,"uniqueKey":"filters.work_email.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"filters.work_email","typeLabel":"string | string[]"},"personal_emails":{"oneOf":[{"type":"string","description":"An email address, looked up exactly as `work_email` is: the two are interchangeable. A string, or an array of up to 10 addresses that are OR-joined; sent with `work_email` or `mobile_phone`, the person must have all of them.","maxLength":254,"minLength":1,"uniqueKey":"filters.personal_emails.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":254,"uniqueKey":"filters.personal_emails.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"An email address, looked up exactly as `work_email` is: the two are interchangeable. A string, or an array of up to 10 addresses that are OR-joined; sent with `work_email` or `mobile_phone`, the person must have all of them.","maxItems":10,"uniqueKey":"filters.personal_emails.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"filters.personal_emails","typeLabel":"string | string[]"},"mobile_phone":{"oneOf":[{"type":"string","description":"A phone number in E.164 with the leading + (e.g. +14155552671); one without a country code is read as a US number. The provider's best match for it is looked up, then searched with every other filter; a company's number finds nobody. A string, or an array of up to 10 numbers that are OR-joined; when none of them finds anyone the search gives no rows and bills nothing. Sent with `work_email` or `personal_emails`, the person must have all of them. A field none of whose values is a phone number answers 422 FILTER_VALUE_UNRESOLVED.","maxLength":254,"minLength":1,"uniqueKey":"filters.mobile_phone.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":254,"uniqueKey":"filters.mobile_phone.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"A phone number in E.164 with the leading + (e.g. +14155552671); one without a country code is read as a US number. The provider's best match for it is looked up, then searched with every other filter; a company's number finds nobody. A string, or an array of up to 10 numbers that are OR-joined; when none of them finds anyone the search gives no rows and bills nothing. Sent with `work_email` or `personal_emails`, the person must have all of them. A field none of whose values is a phone number answers 422 FILTER_VALUE_UNRESOLVED.","maxItems":10,"uniqueKey":"filters.mobile_phone.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"filters.mobile_phone","typeLabel":"string | string[]"},"job_title":{"oneOf":[{"type":"string","description":"Current job title (e.g. chief financial officer), matched exactly in any case together with its common forms (cfo, vp of sales / vice president of sales / vp sales); a string or an array of titles — use `keywords` for partial matches and GET /prospects/autocomplete?field=title for suggestions.","uniqueKey":"filters.job_title.oneOf.0","typeLabel":"string"},{"type":"number","description":"Current job title (e.g. chief financial officer), matched exactly in any case together with its common forms (cfo, vp of sales / vice president of sales / vp sales); a string or an array of titles — use `keywords` for partial matches and GET /prospects/autocomplete?field=title for suggestions.","uniqueKey":"filters.job_title.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Current job title (e.g. chief financial officer), matched exactly in any case together with its common forms (cfo, vp of sales / vice president of sales / vp sales); a string or an array of titles — use `keywords` for partial matches and GET /prospects/autocomplete?field=title for suggestions.","uniqueKey":"filters.job_title.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.job_title.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Current job title (e.g. chief financial officer), matched exactly in any case together with its common forms (cfo, vp of sales / vice president of sales / vp sales); a string or an array of titles — use `keywords` for partial matches and GET /prospects/autocomplete?field=title for suggestions.","uniqueKey":"filters.job_title.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.job_title","typeLabel":"string | number | boolean | string[]"},"job_company_location_name":{"oneOf":[{"type":"string","description":"City of the current employer's headquarters as a location name (e.g. san francisco, california, united states), searched as the area the city covers; resolve with GET /prospects/autocomplete?field=location.","uniqueKey":"filters.job_company_location_name.oneOf.0","typeLabel":"string"},{"type":"number","description":"City of the current employer's headquarters as a location name (e.g. san francisco, california, united states), searched as the area the city covers; resolve with GET /prospects/autocomplete?field=location.","uniqueKey":"filters.job_company_location_name.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"City of the current employer's headquarters as a location name (e.g. san francisco, california, united states), searched as the area the city covers; resolve with GET /prospects/autocomplete?field=location.","uniqueKey":"filters.job_company_location_name.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.job_company_location_name.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"City of the current employer's headquarters as a location name (e.g. san francisco, california, united states), searched as the area the city covers; resolve with GET /prospects/autocomplete?field=location.","uniqueKey":"filters.job_company_location_name.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.job_company_location_name","typeLabel":"string | number | boolean | string[]"},"location_name":{"oneOf":[{"type":"string","description":"City the person lives in, as a location name (e.g. london, greater london, united kingdom), searched as the area the city covers, so some suburbs count; resolve with GET /prospects/autocomplete?field=location.","uniqueKey":"filters.location_name.oneOf.0","typeLabel":"string"},{"type":"number","description":"City the person lives in, as a location name (e.g. london, greater london, united kingdom), searched as the area the city covers, so some suburbs count; resolve with GET /prospects/autocomplete?field=location.","uniqueKey":"filters.location_name.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"City the person lives in, as a location name (e.g. london, greater london, united kingdom), searched as the area the city covers, so some suburbs count; resolve with GET /prospects/autocomplete?field=location.","uniqueKey":"filters.location_name.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.location_name.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"City the person lives in, as a location name (e.g. london, greater london, united kingdom), searched as the area the city covers, so some suburbs count; resolve with GET /prospects/autocomplete?field=location.","uniqueKey":"filters.location_name.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.location_name","typeLabel":"string | number | boolean | string[]"},"education.school.name":{"oneOf":[{"type":"string","description":"Lower-case name of a school attended (e.g. stanford university); resolve with GET /prospects/autocomplete?field=school.","uniqueKey":"filters.education\\.school\\.name.oneOf.0","typeLabel":"string"},{"type":"number","description":"Lower-case name of a school attended (e.g. stanford university); resolve with GET /prospects/autocomplete?field=school.","uniqueKey":"filters.education\\.school\\.name.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Lower-case name of a school attended (e.g. stanford university); resolve with GET /prospects/autocomplete?field=school.","uniqueKey":"filters.education\\.school\\.name.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.education\\.school\\.name.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Lower-case name of a school attended (e.g. stanford university); resolve with GET /prospects/autocomplete?field=school.","uniqueKey":"filters.education\\.school\\.name.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.education\\.school\\.name","typeLabel":"string | number | boolean | string[]"},"experience.title.name":{"oneOf":[{"type":"string","description":"Exact lower-case title held at any past job; a string or an array of titles.","uniqueKey":"filters.experience\\.title\\.name.oneOf.0","typeLabel":"string"},{"type":"number","description":"Exact lower-case title held at any past job; a string or an array of titles.","uniqueKey":"filters.experience\\.title\\.name.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Exact lower-case title held at any past job; a string or an array of titles.","uniqueKey":"filters.experience\\.title\\.name.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.experience\\.title\\.name.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Exact lower-case title held at any past job; a string or an array of titles.","uniqueKey":"filters.experience\\.title\\.name.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.experience\\.title\\.name","typeLabel":"string | number | boolean | string[]"},"experience.company.website":{"oneOf":[{"type":"string","description":"Free text: the website host of any past employer (e.g. stripe.com). The scheme, www. and a trailing slash are stripped and both the host+path and host-only forms are tried, so a full URL still matches; a host the provider does not store matches nothing. A string, or an array of hosts that are OR-joined.","uniqueKey":"filters.experience\\.company\\.website.oneOf.0","typeLabel":"string"},{"type":"number","description":"Free text: the website host of any past employer (e.g. stripe.com). The scheme, www. and a trailing slash are stripped and both the host+path and host-only forms are tried, so a full URL still matches; a host the provider does not store matches nothing. A string, or an array of hosts that are OR-joined.","uniqueKey":"filters.experience\\.company\\.website.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Free text: the website host of any past employer (e.g. stripe.com). The scheme, www. and a trailing slash are stripped and both the host+path and host-only forms are tried, so a full URL still matches; a host the provider does not store matches nothing. A string, or an array of hosts that are OR-joined.","uniqueKey":"filters.experience\\.company\\.website.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.experience\\.company\\.website.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Free text: the website host of any past employer (e.g. stripe.com). The scheme, www. and a trailing slash are stripped and both the host+path and host-only forms are tried, so a full URL still matches; a host the provider does not store matches nothing. A string, or an array of hosts that are OR-joined.","uniqueKey":"filters.experience\\.company\\.website.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.experience\\.company\\.website","typeLabel":"string | number | boolean | string[]"},"job_start_date":{"oneOf":[{"type":"string","description":"Months in current role: finds people who started their current role within the last N months. Send N as a number (6 finds people who started in the last 6 months), or the earliest start month as YYYY-MM or YYYY-MM-DD (started on or after the first day of that month); with several values the earliest start applies, and 0 is no filter.","uniqueKey":"filters.job_start_date.oneOf.0","typeLabel":"string"},{"type":"number","description":"Months in current role: finds people who started their current role within the last N months. Send N as a number (6 finds people who started in the last 6 months), or the earliest start month as YYYY-MM or YYYY-MM-DD (started on or after the first day of that month); with several values the earliest start applies, and 0 is no filter.","uniqueKey":"filters.job_start_date.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Months in current role: finds people who started their current role within the last N months. Send N as a number (6 finds people who started in the last 6 months), or the earliest start month as YYYY-MM or YYYY-MM-DD (started on or after the first day of that month); with several values the earliest start applies, and 0 is no filter.","uniqueKey":"filters.job_start_date.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.job_start_date.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Months in current role: finds people who started their current role within the last N months. Send N as a number (6 finds people who started in the last 6 months), or the earliest start month as YYYY-MM or YYYY-MM-DD (started on or after the first day of that month); with several values the earliest start applies, and 0 is no filter.","uniqueKey":"filters.job_start_date.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.job_start_date","typeLabel":"string | number | boolean | string[]"},"skills":{"oneOf":[{"type":"string","description":"Lower-case skill (e.g. python); a string, or an array of skills any of which may match — resolve with GET /prospects/autocomplete?field=skill.","uniqueKey":"filters.skills.oneOf.0","typeLabel":"string"},{"type":"number","description":"Lower-case skill (e.g. python); a string, or an array of skills any of which may match — resolve with GET /prospects/autocomplete?field=skill.","uniqueKey":"filters.skills.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Lower-case skill (e.g. python); a string, or an array of skills any of which may match — resolve with GET /prospects/autocomplete?field=skill.","uniqueKey":"filters.skills.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.skills.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Lower-case skill (e.g. python); a string, or an array of skills any of which may match — resolve with GET /prospects/autocomplete?field=skill.","uniqueKey":"filters.skills.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.skills","typeLabel":"string | number | boolean | string[]"},"certifications.name":{"oneOf":[{"type":"string","description":"Lower-case certification name (e.g. pmp); a string or an array.","uniqueKey":"filters.certifications\\.name.oneOf.0","typeLabel":"string"},{"type":"number","description":"Lower-case certification name (e.g. pmp); a string or an array.","uniqueKey":"filters.certifications\\.name.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Lower-case certification name (e.g. pmp); a string or an array.","uniqueKey":"filters.certifications\\.name.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","uniqueKey":"filters.certifications\\.name.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Lower-case certification name (e.g. pmp); a string or an array.","uniqueKey":"filters.certifications\\.name.oneOf.3","typeLabel":"string[]"}],"uniqueKey":"filters.certifications\\.name","typeLabel":"string | number | boolean | string[]"},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"filters.keywords.items.[INDEX]","typeLabel":"string"},"maxItems":50,"description":"Free text: up to 50 terms (200 chars each), each matched against the current job title only and OR-joined, so any one may match. Terms match WHOLE words in any case (growth matches Head of Growth, not Growthwise); plural and related forms are added (engineer also finds engineers and engineering), and * or ? are ignored. A term with no text other than wildcards is ignored, and a list holding only such terms does not count as search criteria.","uniqueKey":"filters.keywords","typeLabel":"string[]"},"excludedKeywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"filters.excludedKeywords.items.[INDEX]","typeLabel":"string"},"maxItems":50,"description":"Free text: up to 50 terms (200 chars each) using exactly the same matching rules as `keywords`, but REMOVING every prospect whose current job title matches any one of them — keywords [engineer] with excludedKeywords [infrastructure] keeps Engineer VP and drops Engineer VP Infrastructure. It reads the whole job title, so it also removes rows matched by `job_title`. A term with no text other than wildcards is ignored, since it would remove every prospect that has a job title. Exclusions only narrow a result set: on their own they are not search criteria and a request carrying nothing else is rejected.","uniqueKey":"filters.excludedKeywords","typeLabel":"string[]"},"rangeInputs":{"type":"object","properties":{"job_company_employee_count":{"type":"object","properties":{"min":{"type":"number","description":"Inclusive lower bound (0 is treated as no bound).","uniqueKey":"filters.rangeInputs.job_company_employee_count.min","typeLabel":"number"},"max":{"type":"number","description":"Inclusive upper bound (0 is treated as no bound).","uniqueKey":"filters.rangeInputs.job_company_employee_count.max","typeLabel":"number"}},"description":"Headcount of the current employer; accepted values are whole numbers and both bounds are inclusive. A min of 0 is ignored rather than applied, so cap headcount with max alone.","uniqueKey":"filters.rangeInputs.job_company_employee_count","typeLabel":"object"},"inferred_years_experience":{"type":"object","properties":{"min":{"type":"number","description":"Inclusive lower bound (0 is treated as no bound).","uniqueKey":"filters.rangeInputs.inferred_years_experience.min","typeLabel":"number"},"max":{"type":"number","description":"Inclusive upper bound (0 is treated as no bound).","uniqueKey":"filters.rangeInputs.inferred_years_experience.max","typeLabel":"number"}},"description":"Total years of professional experience; accepted values are whole numbers of years and both bounds are inclusive. A min of 0 is ignored rather than applied.","uniqueKey":"filters.rangeInputs.inferred_years_experience","typeLabel":"object"},"job_company_total_funding_raised":{"type":"object","properties":{"min":{"type":"number","description":"Inclusive lower bound (0 is treated as no bound).","uniqueKey":"filters.rangeInputs.job_company_total_funding_raised.min","typeLabel":"number"},"max":{"type":"number","description":"Inclusive upper bound (0 is treated as no bound).","uniqueKey":"filters.rangeInputs.job_company_total_funding_raised.max","typeLabel":"number"}},"description":"Total funding raised by the current employer; accepted values are whole US dollars, not millions (10000000 means $10M), and both bounds are inclusive. A min of 0 is ignored rather than applied.","uniqueKey":"filters.rangeInputs.job_company_total_funding_raised","typeLabel":"object"}},"description":"Numeric range filters, each key one of exactly: `job_company_employee_count`, `inferred_years_experience`, `job_company_total_funding_raised` (any other key is rejected). Each value is `{ min?, max? }` with at least one bound and min \u003c= max; several ranges AND with each other and with every other filter.","uniqueKey":"filters.rangeInputs","typeLabel":"object"},"company_filters":{"type":"object","properties":{"status":{"type":"array","items":{"type":"object","properties":{"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.company_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.company_filters.status.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","enum":["active","acquired","closed"],"isRequired":true,"uniqueKey":"filters.company_filters.status.items.[INDEX].value","typeLabel":"enum\u003cstring>"}},"required":["label","status","value"],"uniqueKey":"filters.company_filters.status.items.[INDEX]","typeLabel":"object"},"description":"Entries whose `value` is one of exactly: active, acquired, closed. Include values are OR-joined and every exclude value is removed; this filter ANDs with the others.","uniqueKey":"filters.company_filters.status","typeLabel":"object[]"},"tags":{"type":"array","items":{"type":"object","properties":{"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.company_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.company_filters.tags.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","enum":["venture-backed-startup","is-school","is-government","raised-from-top-vc"],"isRequired":true,"uniqueKey":"filters.company_filters.tags.items.[INDEX].value","typeLabel":"enum\u003cstring>"}},"required":["label","status","value"],"uniqueKey":"filters.company_filters.tags.items.[INDEX]","typeLabel":"object"},"description":"Entries whose `value` is one of exactly: venture-backed-startup, is-school, is-government, raised-from-top-vc. Include values are OR-joined and every exclude value is removed; this filter ANDs with the others.","uniqueKey":"filters.company_filters.tags","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.company_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.company_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.company_filters.acceleratorsV2.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.company_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.company_filters.acceleratorsV2","typeLabel":"object[]"},"stage":{"type":"array","items":{"type":"object","properties":{"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.company_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.company_filters.stage.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","enum":["no_funding_yet","pre_seed","seed","series_a","series_b","series_c","series_d","series_e","series_f","series_g","series_h","series_i","series_j","private_equity","venture_other","public","acquired","closed","unknown"],"isRequired":true,"uniqueKey":"filters.company_filters.stage.items.[INDEX].value","typeLabel":"enum\u003cstring>"}},"required":["label","status","value"],"uniqueKey":"filters.company_filters.stage.items.[INDEX]","typeLabel":"object"},"description":"Entries whose `value` is one of exactly: no_funding_yet, pre_seed, seed, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, series_i, series_j, private_equity, venture_other, public, acquired, closed, unknown. Include values are OR-joined and every exclude value is removed; this filter ANDs with the others.","uniqueKey":"filters.company_filters.stage","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.company_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.company_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.company_filters.investors.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.company_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.company_filters.investors","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.company_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.company_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.company_filters.technologies.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.company_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.company_filters.technologies","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.company_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.company_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.company_filters.industriesV2.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.company_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.company_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.company_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.company_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.company_filters.linkedinIndustries.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.company_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.company_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.company_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.company_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.company_filters.crunchbaseCategories.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.company_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.company_filters.crunchbaseCategories","typeLabel":"object[]"},"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.company_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.company_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.company_filters.naicsCodes.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.company_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.company_filters.naicsCodes","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.company_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.company_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.company_filters.officeLocationsV2.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["value","label","status"],"uniqueKey":"filters.company_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.company_filters.officeLocationsV2","typeLabel":"object[]"},"fortuneRankings":{"type":"array","items":{"type":"object","properties":{"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.company_filters.fortuneRankings.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","enum":["fortune-500","forbes-global-2000"],"isRequired":true,"uniqueKey":"filters.company_filters.fortuneRankings.items.[INDEX].value","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["include"],"isRequired":true,"uniqueKey":"filters.company_filters.fortuneRankings.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["label","value","status"],"uniqueKey":"filters.company_filters.fortuneRankings.items.[INDEX]","typeLabel":"object"},"description":"People whose current employer is on a list: entries whose `value` is one of exactly: fortune-500 (the Fortune 500), forbes-global-2000 (the Forbes Global 2000). Include only; several lists are OR-joined.","uniqueKey":"filters.company_filters.fortuneRankings","typeLabel":"object[]"},"keywords":{"type":"array","items":{"type":"string","uniqueKey":"filters.company_filters.keywords.items.[INDEX]","typeLabel":"string"},"description":"Free-text keywords matched against company names and descriptions; any may match.","uniqueKey":"filters.company_filters.keywords","typeLabel":"string[]"},"crunchbaseCategoryGroups":{"type":"array","items":{"type":"string","uniqueKey":"filters.company_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.company_filters.crunchbaseCategoryGroups","typeLabel":"string[]"},"linkedinSlugs":{"type":"array","items":{"type":"string","uniqueKey":"filters.company_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.company_filters.linkedinSlugs","typeLabel":"string[]"},"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.company_filters.lastFundingUSD.min","typeLabel":"number"},"max":{"type":"number","description":"Inclusive upper bound; 0 or less is no bound.","uniqueKey":"filters.company_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.company_filters.lastFundingUSD","typeLabel":"object"},"foundedOn":{"type":"object","properties":{"start":{"type":"string","description":"Earliest date, ISO-8601 (e.g. 2020-01-01).","uniqueKey":"filters.company_filters.foundedOn.start","typeLabel":"string"},"end":{"type":"string","description":"Latest date, ISO-8601 (e.g. 2024-12-31).","uniqueKey":"filters.company_filters.foundedOn.end","typeLabel":"string"}},"description":"Founding-date range `{ start?, end? }` as ISO-8601 dates.","uniqueKey":"filters.company_filters.foundedOn","typeLabel":"object"},"lastFundedOn":{"type":"object","properties":{"start":{"type":"string","description":"Earliest date, ISO-8601 (e.g. 2020-01-01).","uniqueKey":"filters.company_filters.lastFundedOn.start","typeLabel":"string"},"end":{"type":"string","description":"Latest date, ISO-8601 (e.g. 2024-12-31).","uniqueKey":"filters.company_filters.lastFundedOn.end","typeLabel":"string"}},"description":"Date range of the most recent funding round, `{ start?, end? }` as ISO-8601 dates.","uniqueKey":"filters.company_filters.lastFundedOn","typeLabel":"object"}},"description":"Filters on the person's CURRENT employer, in the company search vocabulary and value shapes (the same as POST /companies/search `filters`, limited to these keys): include/exclude fields take `[{ status, value, label }]` entries, list fields arrays of strings, `lastFundingUSD` `{ min, max }` and the date ranges `{ start, end }`. Every filter here ANDs with the rest of the search, and any of them makes it a search of people at matching companies. Only people whose current employer the provider has identified can match.","uniqueKey":"filters.company_filters","typeLabel":"object"}},"description":"Literal filters, one of the four filter sources, in the vocabulary of POST /prospects/search. People filters in the search vocabulary: include/exclude fields take `[{ status, value }]` entries, term fields a string or an array of strings, `rangeInputs` `{ min, max }` ranges — every field and its accepted values are listed by GET /prospects/filter-options. On this endpoint a value outside a field's listed vocabulary is refused with 422 VALIDATION_FAILED, naming the field and the value, before anything is billed; so is a filter the search no longer serves (sex, github_url, github_username, facebook_url, job_title_sub_role, experience.title.sub_role, experience.company.industry, experience.company.location.country, experience.company.location.name, experience.company.location.continent, experience.company.type, location_continent, job_company_location_continent) and an `exclude` entry on education.degrees (the degree filter takes includes only; size and revenue excludes are searched). One exception: `languages.name` also accepts these other names of listed languages, searched as the listed one: bangla, farsi, panjabi, slovene, chinese, mandarin, putonghua, tagalog, filipino, sinhala, khmer, central khmer, hakka chinese, hokkien, taiwanese, newari, northern frisian, western frisian, ndebele, north ndebele, south ndebele, assyrian neo-aramaic. Must contain at least one non-empty value.","uniqueKey":"filters","typeLabel":"object"},"savedSearchId":{"type":"string","description":"Id of one of your PEOPLE saved searches to take the filters from instead of `filters` (a company 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 people 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 who 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 /prospects/search takes it: `filters`, `savedSearchId`, `savedSearchName` or `query`. A count has no paging and no `linkedinUrl` lookup.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"filters":{"industry":"\u003cstring>","job_title_levels":"\u003cstring>","job_title_role":"\u003cstring>","job_company_size":"\u003cstring>","job_company_inferred_revenue":"\u003cstring>","job_company_industry":"\u003cstring>","job_company_location_country":"\u003cstring>","job_company_location_region":"\u003cstring>","experience.title.levels":"\u003cstring>","experience.title.role":"\u003cstring>","languages.name":"\u003cstring>","location_country":"\u003cstring>","location_region":"\u003cstring>","education.degrees":"\u003cstring>","job_company_name":"\u003cstring>","job_company_website":"\u003cstring>","linkedin_url":"\u003cstring>","experience.company.name":"\u003cstring>","full_name":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","work_email":"\u003cstring>","personal_emails":"\u003cstring>","mobile_phone":"\u003cstring>","job_title":"\u003cstring>","job_company_location_name":"\u003cstring>","location_name":"\u003cstring>","education.school.name":"\u003cstring>","experience.title.name":"\u003cstring>","experience.company.website":"\u003cstring>","job_start_date":"\u003cstring>","skills":"\u003cstring>","certifications.name":"\u003cstring>","keywords":["\u003cstring>"],"excludedKeywords":["\u003cstring>"],"rangeInputs":{"job_company_employee_count":{"min":123,"max":123},"inferred_years_experience":{"min":123,"max":123},"job_company_total_funding_raised":{"min":123,"max":123}},"company_filters":{"status":[{"label":"\u003cstring>"}],"tags":[{"label":"\u003cstring>"}],"acceleratorsV2":[{"value":"\u003cstring>","label":"\u003cstring>"}],"stage":[{"label":"\u003cstring>"}],"investors":[{"value":"\u003cstring>","label":"\u003cstring>"}],"technologies":[{"value":"\u003cstring>","label":"\u003cstring>"}],"industriesV2":[{"value":"\u003cstring>","label":"\u003cstring>"}],"linkedinIndustries":[{"value":"\u003cstring>","label":"\u003cstring>"}],"crunchbaseCategories":[{"value":"\u003cstring>","label":"\u003cstring>"}],"naicsCodes":[{"value":"\u003cstring>","label":"\u003cstring>"}],"officeLocationsV2":[{"value":"\u003cstring>","label":"\u003cstring>"}],"fortuneRankings":[{"label":"\u003cstring>","status":"include"}],"keywords":["\u003cstring>"],"crunchbaseCategoryGroups":["\u003cstring>"],"linkedinSlugs":["\u003cstring>"],"lastFundingUSD":{"min":123,"max":123},"foundedOn":{"start":"\u003cstring>","end":"\u003cstring>"},"lastFundedOn":{"start":"\u003cstring>","end":"\u003cstring>"}}},"savedSearchId":"\u003cstring>","savedSearchName":"\u003cstring>","query":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"15f4537a-c4be-4bbc-84ca-2803cabaaa5a":{"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":"People matching the filters; null while `pending`.","isRequired":true,"uniqueKey":"total.oneOf.0","typeLabel":"integer"},{"type":"null","description":"People 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 /prospects/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[]"},"closestCompanyMatches":{"type":"array","items":{"type":"object","required":["requestedName","name"],"properties":{"requestedName":{"type":"string","isRequired":true,"uniqueKey":"closestCompanyMatches.items.[INDEX].requestedName","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"closestCompanyMatches.items.[INDEX].name","typeLabel":"string"},"domain":{"type":"string","uniqueKey":"closestCompanyMatches.items.[INDEX].domain","typeLabel":"string"}},"uniqueKey":"closestCompanyMatches.items.[INDEX]","typeLabel":"object"},"description":"Only with `query`: each company the sentence named that Smart Search chose between same-named companies for, and the one it chose; empty when it guessed nothing.","uniqueKey":"closestCompanyMatches","typeLabel":"object[]"},"ignoredFilterKeys":{"type":"array","items":{"type":"string","uniqueKey":"ignoredFilterKeys.items.[INDEX]","typeLabel":"string"},"description":"Only with a saved search: stored keys with no search field, left out of the count.","uniqueKey":"ignoredFilterKeys","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"status":"ready","total":18432,"filters":{"job_title_levels":[{"status":"include","value":"vp"}],"job_title_role":[{"status":"include","value":"sales"}],"location_country":[{"status":"include","value":"united states"}]},"unresolvedCriteria":[],"closestCompanyMatches":[],"creditsCharged":0},"examples":{"Example":{"title":"Example","value":{"status":"ready","total":18432,"filters":{"job_title_levels":[{"status":"include","value":"vp"}],"job_title_role":[{"status":"include","value":"sales"}],"location_country":[{"status":"include","value":"united states"}]},"unresolvedCriteria":[],"closestCompanyMatches":[],"creditsCharged":0}}},"exampleType":"examples"}},"exampleType":"examples"},"61ca707a-11b5-404a-a1a7-230f825e4dbf":{"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":{"job_title_levels":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","uniqueKey":"filters.job_title_levels.items.[INDEX].status","typeLabel":"string"},"value":{"type":"string","uniqueKey":"filters.job_title_levels.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"filters.job_title_levels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"filters.job_title_levels","typeLabel":"object[]"},"job_title_role":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","uniqueKey":"filters.job_title_role.items.[INDEX].status","typeLabel":"string"},"value":{"type":"string","uniqueKey":"filters.job_title_role.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"filters.job_title_role.items.[INDEX]","typeLabel":"object"},"uniqueKey":"filters.job_title_role","typeLabel":"object[]"},"location_country":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","uniqueKey":"filters.location_country.items.[INDEX].status","typeLabel":"string"},"value":{"type":"string","uniqueKey":"filters.location_country.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"filters.location_country.items.[INDEX]","typeLabel":"object"},"uniqueKey":"filters.location_country","typeLabel":"object[]"}},"uniqueKey":"filters","typeLabel":"object"},"unresolvedCriteria":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"unresolvedCriteria.items.[INDEX]","typeLabel":"any"},"uniqueKey":"unresolvedCriteria","typeLabel":"any[]"},"closestCompanyMatches":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"closestCompanyMatches.items.[INDEX]","typeLabel":"any"},"uniqueKey":"closestCompanyMatches","typeLabel":"any[]"},"creditsCharged":{"type":"integer","uniqueKey":"creditsCharged","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"status":"pending","total":null,"filters":{"job_title_levels":[{"status":"include","value":"vp"}],"job_title_role":[{"status":"include","value":"sales"}],"location_country":[{"status":"include","value":"united states"}]},"unresolvedCriteria":[],"closestCompanyMatches":[],"creditsCharged":0},"examples":{"Example":{"title":"Example","value":{"status":"pending","total":null,"filters":{"job_title_levels":[{"status":"include","value":"vp"}],"job_title_role":[{"status":"include","value":"sales"}],"location_country":[{"status":"include","value":"united states"}]},"unresolvedCriteria":[],"closestCompanyMatches":[],"creditsCharged":0}}},"exampleType":"examples"}},"exampleType":"examples"},"31a65316-7ea5-47ca-8595-6a73f6d59abc":{"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"},"e9893fe3-7c9c-465f-963e-bbcae41935ad":{"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"},"0a50b2d1-5c3e-4e87-b031-6573ec62059b":{"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"},"f0994ea3-52b5-44f8-a8bf-2a54d409d408":{"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"},"350fd2e1-326d-4073-89c3-7f2f07f0f395":{"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"},"79daff38-1d77-4bdc-821e-98c2893fbac6":{"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"},"1b0ff321-a3ba-4d46-9121-71ddcef02a67":{"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"},"e1af0444-ee26-4846-a1f3-c1ed6e5d1760":{"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"},"4c30e952-d39b-449f-b776-5c7e3dd5c281":{"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":{"4b461194-7e20-43e2-8f87-a337d671ede5":{"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 people matching a search (free) - Fuse API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T16:59:46.579Z","originalFileLocation":"api-reference/data/count-people-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 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. Send the filter source POST /prospects/search takes, exactly one of: query, e.g. \u0026quot;VPs of sales at fintech companies in New York\u0026quot;; 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). A 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. Only keys whose usage plan includes people_count may call it. Rate limit: the plan\u0026#x27;s people_count entry. Errors: - 403 API_NOT_ON_PLAN — The key\u0026#x27;s usage plan does not include people_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 search: every value was retired, or nothing in them is a filter. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: titles, locations, industries, company sizes. - 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. - 429 RATE_LIMITED — The plan\u0026#x27;s per-minute or per-day limit for people_count is spent, or too many query sentences were converted today. 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 people matching a search (free) - Fuse API\">\u003cmeta data-mint-head property=\"og:description\" content=\"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. Send the filter source POST /prospects/search takes, exactly one of: query, e.g. \u0026quot;VPs of sales at fintech companies in New York\u0026quot;; 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). A 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. Only keys whose usage plan includes people_count may call it. Rate limit: the plan\u0026#x27;s people_count entry. Errors: - 403 API_NOT_ON_PLAN — The key\u0026#x27;s usage plan does not include people_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 search: every value was retired, or nothing in them is a filter. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: titles, locations, industries, company sizes. - 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. - 429 RATE_LIMITED — The plan\u0026#x27;s per-minute or per-day limit for people_count is spent, or too many query sentences were converted today. 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-people-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+people+matching+a+search+%28free%29\u0026amp;description=Count+how+many+people+match+a+plain-English+sentence%2C+a+saved+search+or+people-search+filters+%28job+title%2C+seniority%2C+department%2C+employer%2C+industry%2C+location%2C+h\u0026amp;theme=6edc0ab12d2194e24d86a864\u0026amp;signature=9dfd9eb6e114d100d1929fef3b594e767d6b686563860429c78fc14061f698a0\">\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 people matching a search (free) - Fuse API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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. Send the filter source POST /prospects/search takes, exactly one of: query, e.g. \u0026quot;VPs of sales at fintech companies in New York\u0026quot;; 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). A 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. Only keys whose usage plan includes people_count may call it. Rate limit: the plan\u0026#x27;s people_count entry. Errors: - 403 API_NOT_ON_PLAN — The key\u0026#x27;s usage plan does not include people_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 search: every value was retired, or nothing in them is a filter. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: titles, locations, industries, company sizes. - 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. - 429 RATE_LIMITED — The plan\u0026#x27;s per-minute or per-day limit for people_count is spent, or too many query sentences were converted today. 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+people+matching+a+search+%28free%29\u0026amp;description=Count+how+many+people+match+a+plain-English+sentence%2C+a+saved+search+or+people-search+filters+%28job+title%2C+seniority%2C+department%2C+employer%2C+industry%2C+location%2C+h\u0026amp;theme=6edc0ab12d2194e24d86a864\u0026amp;signature=9dfd9eb6e114d100d1929fef3b594e767d6b686563860429c78fc14061f698a0\">\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-people-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-people-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-people-matching-a-search-free#webpage\",\"url\":\"https://docs.fuseai.com/api-reference/data/count-people-matching-a-search-free\",\"name\":\"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. Send 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). A 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. Only keys whose usage plan includes people_count may call it. Rate limit: the plan's people_count entry. Errors: - 403 API_NOT_ON_PLAN — The key's usage plan does not include people_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 search: every value was retired, or nothing in them is a filter. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: titles, locations, industries, company sizes. - 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. - 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. Requires one of the following token scopes: data.\",\"dateModified\":\"2026-10-29T16:59:46.579Z\",\"isPartOf\":{\"@id\":\"https://docs.fuseai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fuseai.com/api-reference/data/count-people-matching-a-search-free#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fuseai.com/api-reference/data/count-people-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 people matching a search (free)\",\"item\":\"https://docs.fuseai.com/api-reference/data/count-people-matching-a-search-free\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fuseai.com/api-reference/data/count-people-matching-a-search-free#apireference\",\"headline\":\"Count people matching a search (free)\",\"name\":\"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. Send 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). A 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. Only keys whose usage plan includes people_count may call it. Rate limit: the plan's people_count entry. Errors: - 403 API_NOT_ON_PLAN — The key's usage plan does not include people_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 search: every value was retired, or nothing in them is a filter. - 422 QUERY_FILTERS_INVALID — The query could not be turned into filters. Name concrete criteria: titles, locations, industries, company sizes. - 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. - 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. Requires one of the following token scopes: data.\",\"url\":\"https://docs.fuseai.com/api-reference/data/count-people-matching-a-search-free\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fuseai.com/api-reference/data/count-people-matching-a-search-free#webpage\"},\"dateModified\":\"2026-10-29T16:59:46.579Z\",\"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","description":"The usage plan of the calling API key: for each data API the key may call, the credits one call costs and its per-minute and per-day limits. A key without a usage plan gets the public plan. A data API missing from the plan answers 403 API_NOT_ON_PLAN. Rate limit: the `pricing` entry of the plan itself (public plan: 60 per minute, 10000 per day).\n\nErrors:\n- `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `pricing`.\n- `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `pricing` is spent; retry after the Retry-After / RateLimit-Reset seconds.\n\nRequires one of the following token scopes: data.","deprecated":null,"version":null,"openapi":"/openapi.json get /business/data/pricing","href":"/api-reference/data/get-your-keys-usage-plan"},{"title":"Count people matching a search (free)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/people/count","href":"/api-reference/data/count-people-matching-a-search-free"},{"title":"Count companies matching a search (free)","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"},{"title":"Find a company's domain, LinkedIn page and logo (free)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/companies/resolve","href":"/api-reference/data/find-a-companys-domain-linkedin-page-and-logo-free"},{"title":"Find a person's email","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/people/email","href":"/api-reference/data/find-a-persons-email"},{"title":"Find a person's phone","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/people/phone","href":"/api-reference/data/find-a-persons-phone"},{"title":"Verify an email address","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/emails/verify","href":"/api-reference/data/verify-an-email-address"},{"title":"Find emails and phones for up to 100 people","deprecated":null,"version":null,"openapi":"/openapi.json post /business/data/people/enrich-jobs","href":"/api-reference/data/find-emails-and-phones-for-up-to-100-people"},{"title":"Get a people enrichment job's progress and rows","deprecated":null,"version":null,"openapi":"/openapi.json get /business/data/people/enrich-jobs/{jobId}","href":"/api-reference/data/get-a-people-enrichment-jobs-progress-and-rows"}]},{"group":"Prospect search","pages":[{"title":"Get the accepted prospect-search filter values","deprecated":null,"version":null,"openapi":"/openapi.json get /business/prospects/filter-options","href":"/api-reference/prospect-search/get-the-accepted-prospect-search-filter-values"},{"title":"Suggest values for a free-text search field","deprecated":null,"version":null,"openapi":"/openapi.json get /business/prospects/autocomplete","href":"/api-reference/prospect-search/suggest-values-for-a-free-text-search-field"},{"title":"Run a people search","deprecated":null,"version":null,"openapi":"/openapi.json post /business/prospects/search","href":"/api-reference/prospect-search/run-a-people-search"},{"title":"Save people-search results into a list","deprecated":null,"version":null,"openapi":"/openapi.json post /business/prospects/search/save-to-list","href":"/api-reference/prospect-search/save-people-search-results-into-a-list"}]},{"group":"Scheduled sends","pages":[{"title":"The campaign's send queue by status","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaigns/{campaignId}/scheduled-sends","href":"/api-reference/scheduled-sends/the-campaigns-send-queue-by-status"},{"title":"Edit a queued send's copy or time before it goes out","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/scheduled-sends/{sendId}","href":"/api-reference/scheduled-sends/edit-a-queued-sends-copy-or-time-before-it-goes-out"},{"title":"Skip one queued send","deprecated":null,"version":null,"openapi":"/openapi.json post /business/scheduled-sends/{sendId}/skip","href":"/api-reference/scheduled-sends/skip-one-queued-send"},{"title":"Approve queued sends awaiting review","deprecated":null,"version":null,"openapi":"/openapi.json post /business/scheduled-sends/approve","href":"/api-reference/scheduled-sends/approve-queued-sends-awaiting-review"},{"title":"Decline queued sends awaiting review","deprecated":null,"version":null,"openapi":"/openapi.json post /business/scheduled-sends/decline","href":"/api-reference/scheduled-sends/decline-queued-sends-awaiting-review"}]},{"group":"Campaign templates","pages":[{"title":"The workspace's saved campaign templates","deprecated":null,"version":null,"openapi":"/openapi.json get /business/campaign-templates","href":"/api-reference/campaign-templates/the-workspaces-saved-campaign-templates"},{"title":"Save a campaign's sequence as a reusable template","deprecated":null,"version":null,"openapi":"/openapi.json post /business/campaign-templates","href":"/api-reference/campaign-templates/save-a-campaigns-sequence-as-a-reusable-template"},{"title":"Delete a template","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/campaign-templates/{campaignTemplateId}","href":"/api-reference/campaign-templates/delete-a-template"}]},{"group":"Agents","pages":[{"title":"The agent kinds the wizard offers","deprecated":null,"version":null,"openapi":"/openapi.json get /business/agents/signal-types","href":"/api-reference/agents/the-agent-kinds-the-wizard-offers"},{"title":"The token owner's agents across every kind","deprecated":null,"version":null,"openapi":"/openapi.json get /business/agents","href":"/api-reference/agents/the-token-owners-agents-across-every-kind"},{"title":"Create a web monitor agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/web-monitor","href":"/api-reference/agents/create-a-web-monitor-agent"},{"title":"Create a person starting new job agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/person-starting-new-job","href":"/api-reference/agents/create-a-person-starting-new-job-agent"},{"title":"Create a linkedin posts agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/linkedin-posts","href":"/api-reference/agents/create-a-linkedin-posts-agent"},{"title":"Create a person discovery via filters agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/person-discovery-via-filters","href":"/api-reference/agents/create-a-person-discovery-via-filters-agent"},{"title":"Create a job postings agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/job-postings","href":"/api-reference/agents/create-a-job-postings-agent"},{"title":"Create a job posting in location agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/job-posting-in-location","href":"/api-reference/agents/create-a-job-posting-in-location-agent"},{"title":"Create a first person hired in company department agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/first-person-hired-in-company-department","href":"/api-reference/agents/create-a-first-person-hired-in-company-department-agent"},{"title":"Create a first person hired internationally agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/first-person-hired-internationally","href":"/api-reference/agents/create-a-first-person-hired-internationally-agent"},{"title":"Create a company headcount growth agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/company-headcount-growth","href":"/api-reference/agents/create-a-company-headcount-growth-agent"},{"title":"Create a company headcount growth over baseline agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/company-headcount-growth-over-baseline","href":"/api-reference/agents/create-a-company-headcount-growth-over-baseline-agent"},{"title":"Create a company department headcount agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/company-department-headcount","href":"/api-reference/agents/create-a-company-department-headcount-agent"},{"title":"Create a company employee job location in two countries agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/company-employee-job-location-in-two-countries","href":"/api-reference/agents/create-a-company-employee-job-location-in-two-countries-agent"},{"title":"Create a funding announcements agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/funding-announcements","href":"/api-reference/agents/create-a-funding-announcements-agent"},{"title":"Create a people watcher agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/people-watcher","href":"/api-reference/agents/create-a-people-watcher-agent"},{"title":"Create a companies watcher agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/companies-watcher","href":"/api-reference/agents/create-a-companies-watcher-agent"},{"title":"Create a job changes watcher agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/job-changes-watcher","href":"/api-reference/agents/create-a-job-changes-watcher-agent"},{"title":"Create a linkedin profile agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/linkedin-profile","href":"/api-reference/agents/create-a-linkedin-profile-agent"},{"title":"Create a linkedin post agent","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/linkedin-post","href":"/api-reference/agents/create-a-linkedin-post-agent"},{"title":"Canonical values for agent config filters","deprecated":null,"version":null,"openapi":"/openapi.json get /business/agents/autocomplete","href":"/api-reference/agents/canonical-values-for-agent-config-filters"},{"title":"An agent's config as the drawer shows it","deprecated":null,"version":null,"openapi":"/openapi.json get /business/agents/{agentId}","href":"/api-reference/agents/an-agents-config-as-the-drawer-shows-it"},{"title":"Delete an agent (409 while a run is processing)","deprecated":null,"version":null,"openapi":"/openapi.json delete /business/agents/{agentId}","href":"/api-reference/agents/delete-an-agent-409-while-a-run-is-processing"},{"title":"Update a draft agent's config (partial)","deprecated":null,"version":null,"openapi":"/openapi.json patch /business/agents/{agentId}","href":"/api-reference/agents/update-a-draft-agents-config-partial"},{"title":"Start a draft agent (spends credits)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/{agentId}/activate","href":"/api-reference/agents/start-a-draft-agent-spends-credits"},{"title":"Pause an agent (one-way, there is no resume)","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/{agentId}/stop","href":"/api-reference/agents/pause-an-agent-one-way-there-is-no-resume"},{"title":"Copy an agent as a fresh draft","deprecated":null,"version":null,"openapi":"/openapi.json post /business/agents/{agentId}/duplicate","href":"/api-reference/agents/copy-an-agent-as-a-fresh-draft"}]},{"group":"Research","pages":[{"title":"The research providers a run can use","deprecated":null,"version":null,"openapi":"/openapi.json get /business/research/providers","href":"/api-reference/research/the-research-providers-a-run-can-use"},{"title":"Research runs currently in flight","deprecated":null,"version":null,"openapi":"/openapi.json get /business/research/runs","href":"/api-reference/research/research-runs-currently-in-flight"},{"title":"Start a Deep Research run","deprecated":null,"version":null,"openapi":"/openapi.json post /business/research/runs","href":"/api-reference/research/start-a-deep-research-run"},{"title":"A research run's state, report, and result list","deprecated":null,"version":null,"openapi":"/openapi.json get /business/research/runs/{runId}","href":"/api-reference/research/a-research-runs-state-report-and-result-list"},{"title":"A research run's progress events","deprecated":null,"version":null,"openapi":"/openapi.json get /business/research/runs/{runId}/events","href":"/api-reference/research/a-research-runs-progress-events"},{"title":"Cancel an in-flight research run","deprecated":null,"version":null,"openapi":"/openapi.json post /business/research/runs/{runId}/cancel","href":"/api-reference/research/cancel-an-in-flight-research-run"}]},{"group":"Company search","pages":[{"title":"Get the accepted company-search filter values","deprecated":null,"version":null,"openapi":"/openapi.json get /business/companies/filter-options","href":"/api-reference/company-search/get-the-accepted-company-search-filter-values"},{"title":"Suggest values for company and location filters","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 people 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"]}