> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Search people

> Search Apollo's prospect database without consuming enrichment credits.

`searchPeople` returns one page of intentionally sparse prospects. Use it to
narrow a market before calling a credit-consuming enrichment action.

```ts automations/search-apollo-people.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { searchPeople } from "automate.ax/apollo"

export default automation("Find engineering leaders", () => {
  onHttpRequest({ scope: "automation" })
  searchPeople({
    titles: ["VP Engineering", "CTO"],
    seniorities: ["vp", "c_suite"],
    organizationEmployeeRanges: [{ min: 50, max: 500 }],
    organizationLocations: ["United States"],
    perPage: 25,
  })
})
```

Filters include `titles`, `seniorities`, `personLocations`, `emailStatuses`,
`keywords`, `organizationIds`, `organizationDomains` (up to 1,000),
`organizationLocations`, employee and revenue ranges, hiring titles, job
locations/count/date ranges, and employer technology include/exclude sets.
`includeSimilarTitles` expands title matching. Integer/date range objects use
inclusive `min` and `max`. `page` defaults to `1`; `perPage` defaults to `100`
and is limited to 1–100. Optional `account` selects the binding.

Returns `{ people, pagination }`. Search people include a stable `id`, sparse
name/title and employer availability fields, but deliberately omit email
addresses and phone numbers. Pass `id` to `enrichPerson` or `getPerson` when you
need complete data.