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

# Person Search

> Find people with POST /person-search — titles, employers, skills, and location filters.

`POST /person-search` finds people from Huntr's people index using structured filters — job titles, employers, skills, schools, and location.

## Preview match count (free)

```bash theme={null}
curl --request POST \
  --url https://api.tryhuntr.com/person-search-count \
  --header 'content-type: application/json' \
  --header "x-api-key: ${HUNTR_API_KEY}" \
  --data '{
    "query": {
      "currentJobTitle": { "include": ["CTO", "Chief Technology Officer"] },
      "currentCompanyWebsite": { "include": ["stripe.com"] }
    }
  }'
```

## Search people

```bash theme={null}
curl --request POST \
  --url https://api.tryhuntr.com/person-search \
  --header 'content-type: application/json' \
  --header "x-api-key: ${HUNTR_API_KEY}" \
  --data '{
    "query": {
      "currentJobTitle": { "include": ["VP Engineering", "Head of Engineering"] },
      "currentCompanyWebsite": { "include": ["linear.app"] },
      "location": { "include": ["US"] }
    },
    "pagination": { "size": 50 }
  }'
```

## Filter tips

### Scope to a company with `currentCompanyWebsite`

This is the most reliable way to mean **"people at company X"**:

```json theme={null}
{ "currentCompanyWebsite": { "include": ["stripe.com"] } }
```

Do **not** use `linkedin.com` as a company website — that matches broadly, not one employer.

### Job titles use contains match

`"CTO"` matches "Group CTO", "Former CTO", etc. List variants explicitly:

```json theme={null}
{ "currentJobTitle": { "include": ["CTO", "Chief Technology Officer", "Chief Technical Officer"] } }
```

### Past vs current roles

| Filter                                      | Matches                          |
| ------------------------------------------- | -------------------------------- |
| `currentJobTitle` / `currentCompanyWebsite` | Present role                     |
| `pastJobTitle` / `pastCompanyName`          | Previous roles — alumni searches |

### Keyword search

`keyword` scans the full profile when no dedicated filter fits. Prefer explicit title and employer filters when you can.

## Pagination

Same pattern as [company search](/guides/company-search):

* One page per request (max 200)
* Loop with `pagination.token`
* Keep the same `query` between pages

## After you have people

| Next step             | Endpoint                     |
| --------------------- | ---------------------------- |
| Work email            | `POST /person-email`         |
| Full LinkedIn profile | `POST /person-linkedin`      |
| Narrative buyer brief | `POST /research` tier `deep` |

See [Contact enrichment](/guides/contact-enrichment).

## Pricing

Per person returned. Count endpoint is free. See `GET /pricing`.

## Next step

* [Company search](/guides/company-search)
* [Contact enrichment](/guides/contact-enrichment)
* [POST /person-search](/api-reference)