# Hunter

> Hunter is an email finding and verification service. Its API finds professional email addresses
> associated with a company domain, verifies deliverability, enriches people and companies,
> discovers target accounts, and manages leads, lead lists and outreach sequences. Base URL is
> https://api.hunter.io/v2. Authentication is an API key passed as the api_key query parameter,
> the X-API-KEY header, or an Authorization: Bearer header.

Generated by API Evangelist from apis.yml and the artifacts in this repository. Hunter does not
publish an llms.txt of its own — https://hunter.io/llms.txt returned HTTP 404 on 2026-08-13.

## Agent surfaces

- [Remote MCP server](https://mcp.hunter.io/mcp): Streamable HTTP, 100 tools, requires a Hunter API key in the Authorization (Bearer) or X-API-KEY header.
- [MCP manifest](mcp/hunter-mcp.yml): the full tool inventory with the API path each tool calls.
- [Tool crosswalk](mcp/hunter-tool-crosswalk.yml): every MCP tool bound to its backing OpenAPI operationId; 26 bound, 74 MCP-only, 0 REST-only.
- [Agent Skills](skills/_index.yml): thirteen skills published by Hunter itself in hunter-io/claude-plugin, saved here verbatim.
- No A2A agent card: /.well-known/agent-card.json and /.well-known/agent.json return 404 on hunter.io, api.hunter.io and mcp.hunter.io.

## APIs

- [Domain Search](https://hunter.io/api-documentation/v2#domain-search): all email addresses at a domain, with confidence scores and sources.
- [Email Finder](https://hunter.io/api-documentation/v2#email-finder): the most likely address for a named person at a domain.
- [Email Verifier](https://hunter.io/api-documentation/v2#email-verifier): deliverability check for a single address.
- [Email Count](https://hunter.io/api-documentation/v2#email-count): free count of addresses known for a domain.
- [Discover](https://hunter.io/api-documentation/v2#discover): free company search by natural-language query or structured filters.
- [Email Enrichment](https://hunter.io/api-documentation/v2#email-enrichment): person data for an email address or LinkedIn profile.
- [Company Enrichment](https://hunter.io/api-documentation/v2#company-enrichment): firmographics for a domain.
- [Combined Enrichment](https://hunter.io/api-documentation/v2#combined-enrichment): person and company in one call.
- [Leads](https://hunter.io/api-documentation/v2#leads) and [Leads Lists](https://hunter.io/api-documentation/v2#leads_lists): stored prospect records.
- [Campaigns / Sequences](https://hunter.io/api-documentation/v2#campaigns): outreach sequences and recipients.
- [Account](https://hunter.io/api-documentation/v2#account): plan, credits and usage.
- [Logo API](https://logos.hunter.io/): unauthenticated company logo lookup by domain.

## Specs

- [OpenAPI 3.1.0 (full)](openapi/_original/hunter-api-openapi.yml): 25 operations across the documented v2 surface.
- Twelve per-tag OpenAPI documents under `openapi/`, one per product area.
- [JSON Schema](json-schema/hunter-lead-schema.json) and [JSON-LD context](json-ld/hunter-context.jsonld).
- [Postman collection](postman/hunter-api.postman_collection.json).
- Hunter publishes no OpenAPI of its own: /openapi.json, /openapi.yaml, /swagger.json and /api-docs all return 404 on hunter.io and api.hunter.io.

## Runtime semantics

- [Conventions](conventions/hunter-conventions.yml): auth, idempotency, pagination, error envelope, rate-limit signalling.
- Idempotency: the `Idempotency-Key` header is honoured on POST /v2/sequences only, with a 24-hour dedup window and body fingerprinting.
- Pagination: limit/offset with a meta block; Discover People uses a `search_after` cursor; max offset 10,000 and paid-plan gated.
- [Errors](errors/hunter-problem-types.yml): a proprietary `{"errors":[{"id","code","details"}]}` envelope, not RFC 9457. Note that 403 means rate-limited and 429 means out of credits — the inverse of the common convention.
- [Rate limits](rate-limits/hunter-rate-limits.yml): 15 req/s and 500 req/min on most endpoints, 10/s and 300/min on Email Verifier, 5/s and 50/min on Discover. No X-RateLimit response headers are published.
- [Sandbox](sandbox/hunter-sandbox.yml): the literal API key `test-api-key` returns a fixed dummy response on Domain Search, Email Finder and Email Verifier.

## Security and identity

- [Authentication](authentication/hunter-authentication.yml) and [OAuth scopes](scopes/hunter-scopes.yml): two scopes only, `read` and `write`.
- [Well-known documents](well-known/hunter-well-known.yml): OIDC discovery and RFC 8414 metadata on hunter.io; RFC 9728 protected-resource metadata on mcp.hunter.io. No security.txt.
- [Security policy](https://hunter.io/security-policy): written security program with an ongoing bug bounty; no published reporting address.
- [Conformance](conformance/hunter-conformance.yml) and [domain security](security/hunter-domain-security.yml).
- [GDPR compliance](https://help.hunter.io/en/articles/1890029-gdpr-compliance), [DPA](https://hunter.io/data-processing-agreement), [sub-processors](https://hunter.io/subprocessors).

## Operations

- [Lifecycle](lifecycle/hunter-lifecycle.yml): URI-path versioning at v2; no deprecation policy and no Sunset header support.
- [Changelog](changelog/hunter-changelog.yml) — source: https://hunter.io/changelog
- [Status page](https://status.hunter.io)
- [Webhooks](asyncapi/hunter-webhooks.yml): nine events, in Beta; no AsyncAPI document is published.
- [Plans and pricing](plans/hunter-plans-pricing.yml) — source: https://hunter.io/pricing
- [Packages](packages/hunter-packages.yml): no first-party SDK in any registry; six community wrappers, four of them without a release since 2021.

## Docs

- [Developer portal](https://hunter.io/api)
- [API reference](https://hunter.io/api-documentation/v2)
- [Help centre](https://help.hunter.io)
- [Blog](https://hunter.io/blog)
- [Pricing](https://hunter.io/pricing)
- [GitHub organization](https://github.com/hunter-io)