Iby 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.
Description
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`).
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.
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.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.
Ways in
| Route | Source | Call | Required | Docs |
|---|---|---|---|---|
| Official | POST /api/v2/supersearch-enrichment/preview-leads-from-supersearch | API key in $INSTANTLY_API_KEY | Docs |