Home
Providers
Hunter
Hunter
Hunter.io is an email-intelligence and outbound platform that finds, verifies, and enriches professional email addresses at scale. Its public APIs cover Domain Search, Email Finder, Email Verifier, Email Count, Discover (company prospecting), Person/Company/Combined Enrichment, Leads management, and Account/usage inspection. Credit-based metering, plan-tiered monthly allowances, and per-endpoint rate limits make it a reference example of a usage-based B2B data API.
Hunter publishes 8 APIs on the APIs.io network, including Account API, Discover API, Domain Search API, and 5 more. Tagged areas include Email Finder, Email Verifier, Lead Generation, Outreach, and Prospecting.
The Hunter catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Hunter’s developer surface includes authentication, developer portal, documentation, getting-started guide, changelog, engineering blog, signup flow, and 44 more developer resources.
8 APIs
17 Features
Email Finder Email Verifier Lead Generation Outreach Prospecting Enrichment Sales Marketing
On this page
Kin Score
APIs 8
Postman 8
Open Collections 8
Arazzo 11
GraphQL 1
Pricing Plans 1
Rate Limits 1
FinOps 1
Features 17
Vocabularies 1
Spectral Rules 2
JSON Schema 3
JSON Structure 1
Examples 3
Security Posture 2
Agentic Access 1
Resources 51
apis.yml
68 Operational Transparency
Composite quality — 65.7/100 · strong
Contract Quality
18.7 / 25
Developer Ergonomics
11.3 / 20
Commercial Clarity
12.1 / 20
Operational Transparency
8.9 / 13
Agent readiness — 34/100 · agent ready
Machine-Readable Contract
18 / 18
Agentic Access Contract
10 / 10
MCP Server
0 / 12
Machine-Readable Auth
10 / 10
Idempotency
0 / 9
Stable Error Semantics
8 / 8
Request/Response Examples
0 / 7
Rate-Limit Signaling
7 / 7
Typed Event Surface
0 / 6
Agent Skills
0 / 5
Well-Known Catalog
0 / 4
Consent & Bot Identity
0 / 3
A2A Agent Card
0 / 8
Dry-Run / Simulate Mode
0 / 4
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 8
Ready-to-run Postman collections for exercising this provider's APIs.
Scroll for all 8
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Scroll for all 8
Multi-step API workflows described with the Arazzo specification.
Scroll for all 11
GraphQL schemas published by this provider.
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
Notable capabilities this provider offers.
Domain Search returns all emails for a domain with sources, confidence, department, and seniority
Email Finder predicts the most likely address for a person at a company with 0-100 confidence
Email Verifier runs MX, SMTP, regex, disposable, webmail, accept-all, and block checks plus database lookup
Email Count is free and unauthenticated for pre-flight sizing of a domain's email footprint
Discover API for company prospecting via natural language or structured filters
Person, company, and combined enrichment with optional Clearbit-shape response for drop-in migration
Leads API with CRUD, upsert, filtered list, custom attributes, and lead-list scoping
Campaigns API for outbound sequences, recipients, opens, clicks, replies, and unsubscribes
Account API returns plan, reset date, and per-meter usage counters for FinOps
{"Three auth modes" => "api_key query, X-API-KEY header, or Authorization Bearer"}
Token-bucket-style per-endpoint rate limits with 429 responses (5-15 rps, 50-500 rpm)
Monthly credit allowances per plan with reset_date semantics
Chrome and Firefox browser extensions, Google Sheets add-on, and Bulk Tasks UI
Native integrations with Salesforce, HubSpot, Zapier, Pipedrive, Zoho CRM, and many outbound tools
Hunter MCP server and ChatGPT MCP server for agentic email-finder workflows
Hunter Claude Plugin for find, verify, and enrich workflows inside Claude
GDPR-aligned data handling with 451 responses on restricted personal data
Scroll for all 17
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Standalone JSON Schema definitions for this provider's data models.
JSON Structure definitions describing this provider's data shapes.
Example request and response payloads for these APIs.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Recommended x-agentic-access execution contracts for AI agents.
Get Started 3
Portal, sign-up, and the first successful call
Documentation 2
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 15
Pagination, idempotency, versioning, errors, and events
Scroll for all 15
Build 15
SDKs, sample code, and the tooling you integrate with
Scroll for all 15
Access & Security 3
Authentication, authorization, and security posture
Operate 5
Status, limits, changes, and where to get help
Commercial 4
Pricing, plans, and the legal terms of use
Company 1
The organization behind the API
Other 2
Properties that don't map to a standard resource type
Source (apis.yml)
aid: hunter-io
url: https://raw.githubusercontent.com/api-evangelist/hunter-io/refs/heads/main/apis.yml
apis:
- aid: hunter-io:hunter-io-account-api
name: Hunter Account API
description: Account metadata and usage counters.
humanURL: https://hunter.io/api-documentation/v2#domain-search
tags:
- Account
properties:
- type: OpenAPI
url: openapi/hunter-io-account-api-openapi.yml
- type: Documentation
url: https://hunter.io/api-documentation/v2#domain-search
- type: JSONSchema
url: json-schema/hunter-email-schema.json
- type: JSONLD
url: json-ld/hunter-io-context.jsonld
- type: Examples
url: examples/hunter-domain-search-example.json
- type: GraphQL
url: graphql/hunter-io-graphql.md
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-finder
- type: Examples
url: examples/hunter-email-finder-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-verifier
- type: JSONSchema
url: json-schema/hunter-verification-schema.json
- type: Examples
url: examples/hunter-email-verifier-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-count
- type: Documentation
url: https://hunter.io/api-documentation/v2#discover
- type: Documentation
url: https://hunter.io/api-documentation/v2#enrichment
- type: Documentation
url: https://hunter.io/api-documentation/v2#account
- type: Documentation
url: https://hunter.io/api-documentation/v2#leads
- type: JSONSchema
url: json-schema/hunter-lead-schema.json
- aid: hunter-io:hunter-io-discover-api
name: Hunter Discover API
description: Company discovery and prospecting.
humanURL: https://hunter.io/api-documentation/v2#domain-search
tags:
- Discover
properties:
- type: OpenAPI
url: openapi/hunter-io-discover-api-openapi.yml
- type: Documentation
url: https://hunter.io/api-documentation/v2#domain-search
- type: JSONSchema
url: json-schema/hunter-email-schema.json
- type: JSONLD
url: json-ld/hunter-io-context.jsonld
- type: Examples
url: examples/hunter-domain-search-example.json
- type: GraphQL
url: graphql/hunter-io-graphql.md
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-finder
- type: Examples
url: examples/hunter-email-finder-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-verifier
- type: JSONSchema
url: json-schema/hunter-verification-schema.json
- type: Examples
url: examples/hunter-email-verifier-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-count
- type: Documentation
url: https://hunter.io/api-documentation/v2#discover
- type: Documentation
url: https://hunter.io/api-documentation/v2#enrichment
- type: Documentation
url: https://hunter.io/api-documentation/v2#account
- type: Documentation
url: https://hunter.io/api-documentation/v2#leads
- type: JSONSchema
url: json-schema/hunter-lead-schema.json
- aid: hunter-io:hunter-io-domain-search-api
name: Hunter Domain Search API
description: Discover all emails for a domain or company.
humanURL: https://hunter.io/api-documentation/v2#domain-search
tags:
- Domain Search
properties:
- type: OpenAPI
url: openapi/hunter-io-domain-search-api-openapi.yml
- type: Documentation
url: https://hunter.io/api-documentation/v2#domain-search
- type: JSONSchema
url: json-schema/hunter-email-schema.json
- type: JSONLD
url: json-ld/hunter-io-context.jsonld
- type: Examples
url: examples/hunter-domain-search-example.json
- type: GraphQL
url: graphql/hunter-io-graphql.md
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-finder
- type: Examples
url: examples/hunter-email-finder-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-verifier
- type: JSONSchema
url: json-schema/hunter-verification-schema.json
- type: Examples
url: examples/hunter-email-verifier-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-count
- type: Documentation
url: https://hunter.io/api-documentation/v2#discover
- type: Documentation
url: https://hunter.io/api-documentation/v2#enrichment
- type: Documentation
url: https://hunter.io/api-documentation/v2#account
- type: Documentation
url: https://hunter.io/api-documentation/v2#leads
- type: JSONSchema
url: json-schema/hunter-lead-schema.json
- aid: hunter-io:hunter-io-email-count-api
name: Hunter Email Count API
description: Count emails for a domain.
humanURL: https://hunter.io/api-documentation/v2#domain-search
tags:
- Email Count
properties:
- type: OpenAPI
url: openapi/hunter-io-email-count-api-openapi.yml
- type: Documentation
url: https://hunter.io/api-documentation/v2#domain-search
- type: JSONSchema
url: json-schema/hunter-email-schema.json
- type: JSONLD
url: json-ld/hunter-io-context.jsonld
- type: Examples
url: examples/hunter-domain-search-example.json
- type: GraphQL
url: graphql/hunter-io-graphql.md
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-finder
- type: Examples
url: examples/hunter-email-finder-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-verifier
- type: JSONSchema
url: json-schema/hunter-verification-schema.json
- type: Examples
url: examples/hunter-email-verifier-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-count
- type: Documentation
url: https://hunter.io/api-documentation/v2#discover
- type: Documentation
url: https://hunter.io/api-documentation/v2#enrichment
- type: Documentation
url: https://hunter.io/api-documentation/v2#account
- type: Documentation
url: https://hunter.io/api-documentation/v2#leads
- type: JSONSchema
url: json-schema/hunter-lead-schema.json
- aid: hunter-io:hunter-io-email-finder-api
name: Hunter Email Finder API
description: Find the email address of a person at a company.
humanURL: https://hunter.io/api-documentation/v2#domain-search
tags:
- Email Finder
properties:
- type: OpenAPI
url: openapi/hunter-io-email-finder-api-openapi.yml
- type: Documentation
url: https://hunter.io/api-documentation/v2#domain-search
- type: JSONSchema
url: json-schema/hunter-email-schema.json
- type: JSONLD
url: json-ld/hunter-io-context.jsonld
- type: Examples
url: examples/hunter-domain-search-example.json
- type: GraphQL
url: graphql/hunter-io-graphql.md
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-finder
- type: Examples
url: examples/hunter-email-finder-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-verifier
- type: JSONSchema
url: json-schema/hunter-verification-schema.json
- type: Examples
url: examples/hunter-email-verifier-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-count
- type: Documentation
url: https://hunter.io/api-documentation/v2#discover
- type: Documentation
url: https://hunter.io/api-documentation/v2#enrichment
- type: Documentation
url: https://hunter.io/api-documentation/v2#account
- type: Documentation
url: https://hunter.io/api-documentation/v2#leads
- type: JSONSchema
url: json-schema/hunter-lead-schema.json
- aid: hunter-io:hunter-io-email-verifier-api
name: Hunter Email Verifier API
description: Verify the deliverability of an email address.
humanURL: https://hunter.io/api-documentation/v2#domain-search
tags:
- Email Verifier
properties:
- type: OpenAPI
url: openapi/hunter-io-email-verifier-api-openapi.yml
- type: Documentation
url: https://hunter.io/api-documentation/v2#domain-search
- type: JSONSchema
url: json-schema/hunter-email-schema.json
- type: JSONLD
url: json-ld/hunter-io-context.jsonld
- type: Examples
url: examples/hunter-domain-search-example.json
- type: GraphQL
url: graphql/hunter-io-graphql.md
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-finder
- type: Examples
url: examples/hunter-email-finder-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-verifier
- type: JSONSchema
url: json-schema/hunter-verification-schema.json
- type: Examples
url: examples/hunter-email-verifier-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-count
- type: Documentation
url: https://hunter.io/api-documentation/v2#discover
- type: Documentation
url: https://hunter.io/api-documentation/v2#enrichment
- type: Documentation
url: https://hunter.io/api-documentation/v2#account
- type: Documentation
url: https://hunter.io/api-documentation/v2#leads
- type: JSONSchema
url: json-schema/hunter-lead-schema.json
- aid: hunter-io:hunter-io-enrichment-api
name: Hunter Enrichment API
description: Person, company, and combined enrichment.
humanURL: https://hunter.io/api-documentation/v2#domain-search
tags:
- Enrichment
properties:
- type: OpenAPI
url: openapi/hunter-io-enrichment-api-openapi.yml
- type: Documentation
url: https://hunter.io/api-documentation/v2#domain-search
- type: JSONSchema
url: json-schema/hunter-email-schema.json
- type: JSONLD
url: json-ld/hunter-io-context.jsonld
- type: Examples
url: examples/hunter-domain-search-example.json
- type: GraphQL
url: graphql/hunter-io-graphql.md
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-finder
- type: Examples
url: examples/hunter-email-finder-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-verifier
- type: JSONSchema
url: json-schema/hunter-verification-schema.json
- type: Examples
url: examples/hunter-email-verifier-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-count
- type: Documentation
url: https://hunter.io/api-documentation/v2#discover
- type: Documentation
url: https://hunter.io/api-documentation/v2#enrichment
- type: Documentation
url: https://hunter.io/api-documentation/v2#account
- type: Documentation
url: https://hunter.io/api-documentation/v2#leads
- type: JSONSchema
url: json-schema/hunter-lead-schema.json
- aid: hunter-io:hunter-io-leads-api
name: Hunter Leads API
description: Lead management.
humanURL: https://hunter.io/api-documentation/v2#domain-search
tags:
- Leads
properties:
- type: OpenAPI
url: openapi/hunter-io-leads-api-openapi.yml
- type: Documentation
url: https://hunter.io/api-documentation/v2#domain-search
- type: JSONSchema
url: json-schema/hunter-email-schema.json
- type: JSONLD
url: json-ld/hunter-io-context.jsonld
- type: Examples
url: examples/hunter-domain-search-example.json
- type: GraphQL
url: graphql/hunter-io-graphql.md
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-finder
- type: Examples
url: examples/hunter-email-finder-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-verifier
- type: JSONSchema
url: json-schema/hunter-verification-schema.json
- type: Examples
url: examples/hunter-email-verifier-example.json
- type: Documentation
url: https://hunter.io/api-documentation/v2#email-count
- type: Documentation
url: https://hunter.io/api-documentation/v2#discover
- type: Documentation
url: https://hunter.io/api-documentation/v2#enrichment
- type: Documentation
url: https://hunter.io/api-documentation/v2#account
- type: Documentation
url: https://hunter.io/api-documentation/v2#leads
- type: JSONSchema
url: json-schema/hunter-lead-schema.json
name: Hunter
tags:
- Email Finder
- Email Verifier
- Lead Generation
- Outreach
- Prospecting
- Enrichment
- Sales
- Marketing
kind: contract
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
label: Freemium · Self-serve signup
confidence: high
source:
- plans
- authentication
generated: '2026-07-22'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/hunter-io.png
access: 3rd-Party
common:
- type: AgenticAccess
url: agentic-access/hunter-io-agentic-access.yml
- type: DomainSecurity
url: security/hunter-io-domain-security.yml
- type: Authentication
url: authentication/hunter-io-authentication.yml
- type: PostmanWorkspace
url: https://www.postman.com/kinlaneapi/hunter/overview
- type: Arazzo
url: arazzo/hunter-io-add-verified-lead-to-list-workflow.yml
name: Hunter Add Verified Lead To List
- type: Arazzo
url: arazzo/hunter-io-author-finder-workflow.yml
name: Hunter Author Finder
- type: Arazzo
url: arazzo/hunter-io-campaign-lead-builder-workflow.yml
name: Hunter Campaign Lead Builder
- type: Arazzo
url: arazzo/hunter-io-count-gated-domain-search-workflow.yml
name: Hunter Count Gated Domain Search
- type: Arazzo
url: arazzo/hunter-io-credit-guarded-domain-search-workflow.yml
name: Hunter Credit Guarded Domain Search
- type: Arazzo
url: arazzo/hunter-io-discover-to-domain-emails-workflow.yml
name: Hunter Discover To Domain Emails
- type: Arazzo
url: arazzo/hunter-io-domain-to-verified-email-workflow.yml
name: Hunter Domain To Verified Email
- type: Arazzo
url: arazzo/hunter-io-enrich-email-to-lead-workflow.yml
name: Hunter Enrich Email To Lead
- type: Arazzo
url: arazzo/hunter-io-find-verify-create-lead-workflow.yml
name: Hunter Find Verify Create Lead
- type: Arazzo
url: arazzo/hunter-io-reverify-lead-workflow.yml
name: Hunter Reverify Lead
- type: Arazzo
url: arazzo/hunter-io-verify-existing-email-workflow.yml
name: Hunter Verify Existing Email
- type: Portal
url: https://hunter.io
- type: Documentation
url: https://hunter.io/api-documentation
- type: Documentation
url: https://hunter.io/api-documentation/v2
- type: GettingStarted
url: https://hunter.io/api-documentation/v2#introduction
- type: Authentication
url: https://hunter.io/api-documentation/v2#authentication
- type: RateLimits
url: https://hunter.io/api-documentation/v2#rate-limiting
- type: ErrorCodes
url: https://hunter.io/api-documentation/v2#errors
- type: ChangeLog
url: https://hunter.io/api-documentation/v2#changelog
- type: Blog
url: https://hunter.io/blog
- type: Signup
url: https://hunter.io/users/sign_up
- type: PrivacyPolicy
url: https://hunter.io/privacy
- type: TermsOfService
url: https://hunter.io/terms
- type: StatusPage
url: https://status.hunter.io
- type: Support
url: https://hunter.io/contact
- type: GitHubOrganization
url: https://github.com/hunter-io
- url: https://chrome.google.com/webstore/detail/hunter-find-email-address/hgmhmanijnjhaffoampdlllchpolkdnj
name: Hunter Chrome Extension
type: Plugin
- url: https://addons.mozilla.org/en-US/firefox/addon/hunterio/
name: Hunter Firefox Add-on
type: Plugin
- url: https://hunter.io/integrations/salesforce
name: Salesforce Integration
type: Integrations
- url: https://hunter.io/integrations/hubspot
name: HubSpot Integration
type: Integrations
- url: https://hunter.io/integrations/zapier
name: Zapier Integration
type: Integrations
- url: https://hunter.io/integrations/pipedrive
name: Pipedrive Integration
type: Integrations
- url: https://hunter.io/integrations/zoho
name: Zoho CRM Integration
type: Integrations
- url: https://hunter.io/email-pattern
name: Email Pattern Finder
type: Tools
- url: https://hunter.io/email-verifier
name: Email Verifier Tool
type: Tools
- url: https://hunter.io/email-finder
name: Email Finder Tool
type: Tools
- url: https://hunter.io/bulks
name: Bulk Tasks
type: Tools
- url: https://hunter.io/companies
name: Hunter Companies Directory
type: Tools
- url: https://hunter.io/templates
name: Cold Email Templates
type: Resource
- url: https://hunter.io/email-marketing-glossary
name: Email Marketing Glossary
type: Glossary
- url: https://github.com/hunter-io/claude-plugin
name: Hunter Claude Plugin
type: Plugin
- url: https://github.com/hunter-io/chatgpt-mcp
name: Hunter MCP Server for ChatGPT
type: Tools
- url: https://github.com/hunter-io/hunter-mcp
name: Hunter MCP Integration (archived)
type: Tools
- url: https://github.com/hunter-io/mcp-oauth-proxy
name: MCP OAuth Proxy
type: Tools
- url: https://github.com/hunter-io/baseimage-ruby
name: Hunter Ruby Base Image
type: Tools
- url: https://github.com/hunter-io/sentry-ruby
name: Sentry Ruby (Hunter fork)
type: SDKs
- url: plans/hunter-io-plans-pricing.yml
type: Plans
- url: rate-limits/hunter-io-rate-limits.yml
type: RateLimits
- url: finops/hunter-io-finops.yml
type: FinOps
- url: vocabulary/hunter-io-vocabulary.yml
type: Vocabulary
- url: rules/hunter-io-rules.yml
type: SpectralRules
- url: json-structure/hunter-io-structure.json
type: JSONStructure
- type: Features
data:
- Domain Search returns all emails for a domain with sources, confidence, department, and seniority
- Email Finder predicts the most likely address for a person at a company with 0-100 confidence
- Email Verifier runs MX, SMTP, regex, disposable, webmail, accept-all, and block checks plus database lookup
- Email Count is free and unauthenticated for pre-flight sizing of a domain's email footprint
- Discover API for company prospecting via natural language or structured filters
- Person, company, and combined enrichment with optional Clearbit-shape response for drop-in migration
- Leads API with CRUD, upsert, filtered list, custom attributes, and lead-list scoping
- Campaigns API for outbound sequences, recipients, opens, clicks, replies, and unsubscribes
- Account API returns plan, reset date, and per-meter usage counters for FinOps
- Three auth modes: api_key query, X-API-KEY header, or Authorization Bearer
- Token-bucket-style per-endpoint rate limits with 429 responses (5-15 rps, 50-500 rpm)
- Monthly credit allowances per plan with reset_date semantics
- Chrome and Firefox browser extensions, Google Sheets add-on, and Bulk Tasks UI
- Native integrations with Salesforce, HubSpot, Zapier, Pipedrive, Zoho CRM, and many outbound tools
- Hunter MCP server and ChatGPT MCP server for agentic email-finder workflows
- Hunter Claude Plugin for find, verify, and enrich workflows inside Claude
- GDPR-aligned data handling with 451 responses on restricted personal data
sources:
- https://hunter.io/api-documentation
- https://hunter.io/pricing
- https://hunter.io/api
- https://github.com/hunter-io
updated: '2026-05-25'
created: '2026-05-25T00:00:00.000Z'
modified: '2026-05-25'
position: Consuming
description: Hunter.io is an email-intelligence and outbound platform that finds, verifies, and enriches professional email
addresses at scale. Its public APIs cover Domain Search, Email Finder, Email Verifier, Email Count, Discover (company prospecting),
Person/Company/Combined Enrichment, Leads management, and Account/usage inspection. Credit-based metering, plan-tiered monthly
allowances, and per-endpoint rate limits make it a reference example of a usage-based B2B data API.
maintainers:
- FN: Kin Lane
email: info@apievangelist.com
X: apievangelist
url: https://apievangelist.com
specificationVersion: '0.16'