--- title: "Search people by filters without adding CRM records or campaign recipients. Search credits apply; this is not a free provider preview" method: POST path: "/campaigns/audience/search" tags: ["campaigns"] --- # Search people by filters without adding CRM records or campaign recipients. Search credits apply; this is not a free provider preview `POST /campaigns/audience/search` ## Request - Base URL: `https://www.dench.com/api/v1` - URL: `https://www.dench.com/api/v1/campaigns/audience/search` - Auth: one of: - HTTP bearer - HTTP bearer Search people by filters without adding CRM records or campaign recipients. Search credits apply; this is not a free provider preview. ## Request body - object - `sequenceId` string - `filters` object, required - `linkedinUrl` string - `fullName` string - `firstName` string - `lastName` string - `keywords` string: Current-title text only. For profile or work descriptions, use profileKeywords. Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - `companyDomain` string - `companyName` string - `titles` union[]: Current job titles (free text). Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `pastTitles` union[]: Past job titles (free text). - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `personNames` union[] - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `pastSeniorities` union[]: Seniority in any past role, independent of pastCompanyNames/pastTitles. Current seniority vocabulary plus Founding Team. Founder includes Co-Founder; C-level and Founding Team do not imply founder. Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `profileKeywords` union[]: Text in headline/about or any current/past work description. OR includes, global exclusions. Always loose text matching; missing evidence does not match. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `companyKeywords` union[]: Current employer business focus/model (e.g. SaaS, B2B, Cloud), from description/tagline/business tags; distinct from legal companyTypes. Same employer as other current-job filters. Always loose text matching. May need another filter to retrieve candidates. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `seniorities` union[]: Exact enum: Owner, Founder, C-level, Partner, VP, Head, Director, Manager, Senior. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `jobFunctions` union[]: Exact enum, e.g. Sales, Marketing, Software. Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `subFunctions` union[]: Exact enum, e.g. SDR/BDR, Demand Generation. Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `industries` union[]: Exact enum, e.g. Software Development. Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `locations` union[]: Person locations — cities, states, countries, or metros (free text). Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `headcountRanges` union[]: Exact buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `companyNames` union[] - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `pastCompanyNames` union[] - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `companyDomains` union[] - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `companyHeadquarters` union[]: Company HQ locations — cities, states, countries, or metros (free text). Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `companyTypes` union[]: Exact enum: Partnership, Nonprofit, Educational, Privately Held, Public Company, Self-Owned, Self-Employed, Government Agency. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `universities` union[]: Universities attended (free text). Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `skills` union[]: Profile skills (free text). Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `languages` union[]: Spoken languages, e.g. English, German. Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json. - union - string - object - `value` string, required - `exclude` boolean - `exactMatch` boolean - `yearsInRole` object - `min` integer - `max` integer - `yearsAtCompany` object - `min` integer - `max` integer - `daysSinceJobChange` object - `min` integer - `max` integer - `foundedYears` object: Company founded-year range, e.g. {min: 2015, max: 2024}. - `min` integer - `max` integer - `exactMatch` boolean: Match free-text filters as whole strings. Default false: titles ['Founder'] also returns 'Co-Founder' and 'Founder & CEO'. Set true to narrow. Domains, LinkedIn URLs, enum filters and numeric ranges are always exact; keywords is always a loose text probe. - `preferCache` boolean - `limit` integer - `pageToken` string ## Response `200` Successful response - object - `rows` object[], required - `people` unknown[], required - unknown - `recipients` object[], required - `email` string - `linkedinProfileUrl` string - `displayName` string - `personalization` object: Merge values keyed by name, e.g. {"Company":"Acme"} for {{Company}}. - `metadata` object, required - `estimatedCents` number, nullable, required: The search cost ceiling reported by Dench billing, in cents. Null means the receipt is unavailable. - `chargedCents` number, nullable, required: The actual search charge reported by Dench billing, in cents. Null means the receipt is unavailable; results remain valid. ## Other responses - `400`: Invalid request - `401`: Missing or invalid authentication - `404`: Operation or resource not found - `500`: Server error --- [API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)