by Instantly
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.
Updated Sep 27, 2026
search-people.md
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.
Ways in
| Route | Source | Call | Required | Docs |
|---|---|---|---|---|
| Official | POST /api/v2/supersearch-enrichment/preview-leads-from-supersearch | API key in $INSTANTLY_API_KEY | Docs |