---
ref: tool:instantly/search-people
name: Search people
company: company:instantly
workflows: []
access: [api]
tags: [capability:build-audience, category:sales-engagement, has:api]
docs: https://developer.instantly.ai/api-reference/supersearchenrichment/preview-leads-from-supersearch
updated: 2026-09-27
---

# Search people

Returns people from Instantly's SuperSearch lead database who match filters such as job title, department, level, location, industry or employee count, without their email addresses.

Put the filters in `search_filters`, for example `title` with `include` and
`exclude` lists. `POST /api/v2/supersearch-enrichment/count-leads-from-supersearch`
takes the same filters and counts the matches. The preview enriches nothing;
to add the people to a list with their work emails, import them from
SuperSearch. The key needs the `supersearch_enrichments:read` scope (or
`supersearch_enrichments:all`, `all:read`, `all:all`).

## Set up

Use the first option your agent supports.

### API (official)

- Base URL: https://api.instantly.ai
- Endpoint: `POST /api/v2/supersearch-enrichment/preview-leads-from-supersearch`
- Auth: send the header `Authorization: Bearer $INSTANTLY_API_KEY`
- Get a key: https://app.instantly.ai/app/settings/integrations
- Docs: https://developer.instantly.ai/getting-started/authorization

Before doing anything else, make one read-only call to confirm access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.