---
ref: tool:instantly/search-people
name: Search people
company: company:instantly
workflows: []
access: [api]
tags: [capability:find-prospects, 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.

Note: Enriches nothing: import the people from SuperSearch to get work emails. `POST /api/v2/supersearch-enrichment/count-leads-from-supersearch` counts matches; the key needs the `supersearch_enrichments:read` scope.

## 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 anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.