Hunter

Hunter Enrichment API

The Enrichment API from Hunter — 3 operation(s) for enrichment.

GitHub OpenAPI

Operations 3

GET /people/find Enrich a person #
GET /companies/find Enrich a company #
GET /combined/find Enrich a person and company #

Documentation

📖
Documentation
https://hunter.io/api-documentation/v2#domain-search
📖
Documentation
https://hunter.io/api-documentation/v2#email-finder
📖
Documentation
https://hunter.io/api-documentation/v2#email-verifier
📖
Documentation
https://hunter.io/api-documentation/v2#email-count
📖
Documentation
https://hunter.io/api-documentation/v2#account
📖
Documentation
https://hunter.io/api-documentation/v2#discover
📖
Documentation
https://hunter.io/api-documentation/v2#email-enrichment
📖
Documentation
https://hunter.io/api-documentation/v2#company-enrichment
📖
Documentation
https://hunter.io/api-documentation/v2#combined-enrichment
📖
Documentation
https://hunter.io/api-documentation/v2#leads
📖
Documentation
https://hunter.io/api-documentation/v2#leads_lists
📖
Documentation
https://hunter.io/api-documentation/v2#campaigns
📖
Documentation
https://hunter.io/api-documentation/v2#logo

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hunter/refs/heads/main/openapi/hunter-enrichment-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hunter/refs/heads/main/json-schema/hunter-lead-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/hunter/refs/heads/main/json-ld/hunter-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hunter:hunter-enrichment-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hunter-enrichment-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hunter Enrichment API
  version: 2.0.0
  description: 'Find and verify professional email addresses and manage Hunter resources.

    Hunter''s own MCP servers forward the calling AI client''s User-Agent in a reserved `X-MCP-USER-AGENT` request header. It is read only for usage attribution and to record which AI clients an account has connected from, and never changes a response. Per-request attribution resolves it to a fixed list of known clients; the first call from each new client also stores the User-Agent as sent, so a client Hunter does not yet recognise can be identified. There is nothing for an integration to send here.

    Hunter''s MCP servers also identify themselves with `X-SOURCE: hunter-mcp` or `X-SOURCE: hunter-chatgpt`. These reserved markers attribute server-side actions to the MCP channel, separately from ordinary API and product usage. They do not replace API authentication. Ordinary API clients do not need to send these markers.'
  contact:
    name: Hunter Support
    url: https://help.hunter.io
servers:
- url: https://api.hunter.io/v2
  description: Production
security:
- apiKeyQuery: []
- apiKeyHeader: []
- bearerAuth: []
tags:
- name: Enrichment
paths:
  /people/find:
    get:
      operationId: enrichPerson
      summary: Enrich a person
      tags:
      - Enrichment
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      - name: email
        in: query
        description: Email address to enrich.
        schema:
          type: string
          format: email
      - name: linkedin_handle
        in: query
        description: LinkedIn profile handle to enrich.
        schema:
          type: string
      - $ref: '#/components/parameters/ClearbitFormat'
      responses:
        '200':
          description: Enriched person data.
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/person_enrichment_response'
                - $ref: '#/components/schemas/person'
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '451':
          $ref: '#/components/responses/Error'
        default:
          $ref: '#/components/responses/Error'
  /companies/find:
    get:
      operationId: enrichCompany
      summary: Enrich a company
      tags:
      - Enrichment
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      - name: domain
        in: query
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ClearbitFormat'
      responses:
        '200':
          description: Enriched company data.
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/company_enrichment_response'
                - $ref: '#/components/schemas/company'
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        default:
          $ref: '#/components/responses/Error'
  /combined/find:
    get:
      operationId: enrichPersonAndCompany
      summary: Enrich a person and company
      tags:
      - Enrichment
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      - name: email
        in: query
        description: Email address to enrich.
        schema:
          type: string
          format: email
      - name: linkedin_handle
        in: query
        description: LinkedIn profile handle to enrich.
        schema:
          type: string
      - $ref: '#/components/parameters/ClearbitFormat'
      responses:
        '200':
          description: Enriched person and company data.
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/combined_enrichment_response'
                - $ref: '#/components/schemas/combined_clearbit_response'
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '451':
          $ref: '#/components/responses/Error'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    company_facebook:
      type: object
      additionalProperties: false
      required:
      - handle
      - likes
      properties:
        handle:
          $ref: '#/components/schemas/nullable_string'
        likes:
          $ref: '#/components/schemas/nullable_integer'
    combined_enrichment_response:
      type: object
      additionalProperties: false
      required:
      - data
      - meta
      properties:
        data:
          type: object
          additionalProperties: false
          required:
          - person
          - company
          properties:
            person:
              $ref: '#/components/schemas/person'
            company:
              $ref: '#/components/schemas/company'
        meta:
          type: object
          additionalProperties: false
          required:
          - email
          properties:
            email:
              type: string
              format: email
    nullable_integer:
      type:
      - integer
      - 'null'
    person_enrichment_response:
      type: object
      additionalProperties: false
      required:
      - data
      - meta
      properties:
        data:
          $ref: '#/components/schemas/person'
        meta:
          type: object
          additionalProperties: false
          required:
          - email
          properties:
            email:
              type: string
              format: email
    error_response:
      oneOf:
      - $ref: '#/components/schemas/standard_error_response'
      - $ref: '#/components/schemas/legacy_error_response'
    nullable_string:
      type:
      - string
      - 'null'
    standard_error_response:
      type: object
      additionalProperties: false
      required:
      - errors
      properties:
        errors:
          type: array
          items:
            type: object
            additionalProperties: false
            required:
            - id
            - code
            - details
            properties:
              id:
                type: string
              code:
                type: integer
              details:
                type: string
    social_handle:
      type: object
      additionalProperties: false
      required:
      - handle
      properties:
        handle:
          $ref: '#/components/schemas/nullable_string'
    discover_email_counts:
      type: object
      additionalProperties: false
      required:
      - personal
      - generic
      - total
      properties:
        personal:
          $ref: '#/components/schemas/nullable_integer'
        generic:
          $ref: '#/components/schemas/nullable_integer'
        total:
          $ref: '#/components/schemas/nullable_integer'
    company_enrichment_response:
      type: object
      additionalProperties: false
      required:
      - data
      - meta
      properties:
        data:
          $ref: '#/components/schemas/company'
        meta:
          type: object
          additionalProperties: false
          required:
          - domain
          properties:
            domain:
              type: string
    combined_clearbit_response:
      type: object
      additionalProperties: false
      required:
      - person
      - company
      properties:
        person:
          $ref: '#/components/schemas/person'
        company:
          $ref: '#/components/schemas/company'
    person:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - email
      - location
      - timeZone
      - utcOffset
      - geo
      - bio
      - site
      - avatar
      - employment
      - facebook
      - github
      - twitter
      - linkedin
      - googleplus
      - gravatar
      - fuzzy
      - emailProvider
      - indexedAt
      - phone
      - activeAt
      - inactiveAt
      properties:
        id:
          type: string
        name:
          type: object
          additionalProperties: false
          required:
          - fullName
          - givenName
          - familyName
          properties:
            fullName:
              $ref: '#/components/schemas/nullable_string'
            givenName:
              $ref: '#/components/schemas/nullable_string'
            familyName:
              $ref: '#/components/schemas/nullable_string'
        email:
          type: string
          format: email
        location:
          $ref: '#/components/schemas/nullable_string'
        timeZone:
          $ref: '#/components/schemas/nullable_string'
        utcOffset:
          $ref: '#/components/schemas/nullable_integer'
        geo:
          type: object
          additionalProperties: false
          required:
          - city
          - state
          - stateCode
          - country
          - countryCode
          - lat
          - lng
          properties:
            city:
              $ref: '#/components/schemas/nullable_string'
            state:
              $ref: '#/components/schemas/nullable_string'
            stateCode:
              $ref: '#/components/schemas/nullable_string'
            country:
              $ref: '#/components/schemas/nullable_string'
            countryCode:
              $ref: '#/components/schemas/nullable_string'
            lat:
              type:
              - number
              - 'null'
            lng:
              type:
              - number
              - 'null'
        bio:
          $ref: '#/components/schemas/nullable_string'
        site:
          $ref: '#/components/schemas/nullable_string'
        avatar:
          $ref: '#/components/schemas/nullable_string'
        employment:
          type: object
          additionalProperties: false
          required:
          - domain
          - name
          - title
          - role
          - subRole
          - seniority
          properties:
            domain:
              $ref: '#/components/schemas/nullable_string'
            name:
              $ref: '#/components/schemas/nullable_string'
            title:
              $ref: '#/components/schemas/nullable_string'
            role:
              $ref: '#/components/schemas/nullable_string'
            subRole:
              $ref: '#/components/schemas/nullable_string'
            seniority:
              $ref: '#/components/schemas/nullable_string'
        facebook:
          $ref: '#/components/schemas/social_handle'
        github:
          type: object
          additionalProperties: false
          required:
          - handle
          - id
          - avatar
          - company
          - blog
          - followers
          - following
          properties:
            handle:
              $ref: '#/components/schemas/nullable_string'
            id:
              $ref: '#/components/schemas/nullable_string'
            avatar:
              $ref: '#/components/schemas/nullable_string'
            company:
              $ref: '#/components/schemas/nullable_string'
            blog:
              $ref: '#/components/schemas/nullable_string'
            followers:
              $ref: '#/components/schemas/nullable_integer'
            following:
              $ref: '#/components/schemas/nullable_integer'
        twitter:
          type: object
          additionalProperties: false
          required:
          - handle
          - id
          - bio
          - followers
          - following
          - statuses
          - favorites
          - location
          - site
          - avatar
          properties:
            handle:
              $ref: '#/components/schemas/nullable_string'
            id:
              $ref: '#/components/schemas/nullable_string'
            bio:
              $ref: '#/components/schemas/nullable_string'
            followers:
              $ref: '#/components/schemas/nullable_integer'
            following:
              $ref: '#/components/schemas/nullable_integer'
            statuses:
              $ref: '#/components/schemas/nullable_integer'
            favorites:
              $ref: '#/components/schemas/nullable_integer'
            location:
              $ref: '#/components/schemas/nullable_string'
            site:
              $ref: '#/components/schemas/nullable_string'
            avatar:
              $ref: '#/components/schemas/nullable_string'
        linkedin:
          $ref: '#/components/schemas/social_handle'
        googleplus:
          $ref: '#/components/schemas/social_handle'
        gravatar:
          type: object
          additionalProperties: false
          required:
          - handle
          - urls
          - avatar
          - avatars
          properties:
            handle:
              $ref: '#/components/schemas/nullable_string'
            urls:
              type: array
              items:
                type: string
            avatar:
              $ref: '#/components/schemas/nullable_string'
            avatars:
              type: array
              items:
                type: string
        fuzzy:
          type: boolean
        emailProvider:
          $ref: '#/components/schemas/nullable_string'
        indexedAt:
          $ref: '#/components/schemas/nullable_string'
        phone:
          $ref: '#/components/schemas/nullable_string'
        activeAt:
          $ref: '#/components/schemas/nullable_string'
        inactiveAt:
          $ref: '#/components/schemas/nullable_string'
    company:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - legalName
      - domain
      - domainAliases
      - site
      - category
      - tags
      - description
      - foundedYear
      - location
      - timeZone
      - utcOffset
      - geo
      - logo
      - facebook
      - linkedin
      - twitter
      - crunchbase
      - youtube
      - instagram
      - emailProvider
      - type
      - companyType
      - ticker
      - identifiers
      - phone
      - metrics
      - indexedAt
      - tech
      - techCategories
      - fundingRounds
      - parent
      - ultimateParent
      properties:
        id:
          type: string
        name:
          $ref: '#/components/schemas/nullable_string'
        legalName:
          $ref: '#/components/schemas/nullable_string'
        domain:
          type: string
        domainAliases:
          type: array
          items:
            type: string
        site:
          type: object
          additionalProperties: false
          required:
          - phoneNumbers
          - emailAddresses
          properties:
            phoneNumbers:
              type: array
              description: Claimed numbers are omitted. Empty when phone screening is unavailable.
              items:
                type: string
            emailAddresses:
              type: array
              items:
                type: string
                format: email
        category:
          type: object
          additionalProperties: false
          required:
          - sector
          - industryGroup
          - industry
          - subIndustry
          - gicsCode
          - sicCode
          - sic4Codes
          - naicsCode
          - naics6Codes
          - naics6Codes2022
          properties:
            sector:
              $ref: '#/components/schemas/nullable_string'
            industryGroup:
              $ref: '#/components/schemas/nullable_string'
            industry:
              $ref: '#/components/schemas/nullable_string'
            subIndustry:
              $ref: '#/components/schemas/nullable_string'
            gicsCode:
              $ref: '#/components/schemas/nullable_string'
            sicCode:
              $ref: '#/components/schemas/nullable_string'
            sic4Codes:
              type: array
              items:
                type: string
            naicsCode:
              $ref: '#/components/schemas/nullable_string'
            naics6Codes:
              type: array
              items:
                type: string
            naics6Codes2022:
              type: array
              items:
                type: string
        tags:
          type:
          - array
          - 'null'
          items:
            type: string
        description:
          $ref: '#/components/schemas/nullable_string'
        foundedYear:
          $ref: '#/components/schemas/nullable_integer'
        location:
          $ref: '#/components/schemas/nullable_string'
        timeZone:
          $ref: '#/components/schemas/nullable_string'
        utcOffset:
          $ref: '#/components/schemas/nullable_integer'
        geo:
          type: object
          additionalProperties: false
          required:
          - streetNumber
          - streetName
          - subPremise
          - streetAddress
          - city
          - postalCode
          - state
          - stateCode
          - country
          - countryCode
          - lat
          - lng
          properties:
            streetNumber:
              $ref: '#/components/schemas/nullable_string'
            streetName:
              $ref: '#/components/schemas/nullable_string'
            subPremise:
              $ref: '#/components/schemas/nullable_string'
            streetAddress:
              $ref: '#/components/schemas/nullable_string'
            city:
              $ref: '#/components/schemas/nullable_string'
            postalCode:
              $ref: '#/components/schemas/nullable_string'
            state:
              $ref: '#/components/schemas/nullable_string'
            stateCode:
              $ref: '#/components/schemas/nullable_string'
            country:
              $ref: '#/components/schemas/nullable_string'
            countryCode:
              $ref: '#/components/schemas/nullable_string'
            lat:
              type:
              - number
              - 'null'
            lng:
              type:
              - number
              - 'null'
        logo:
          type: string
          format: uri
        facebook:
          $ref: '#/components/schemas/company_facebook'
        linkedin:
          $ref: '#/components/schemas/social_handle'
        twitter:
          type: object
          additionalProperties: false
          required:
          - handle
          - id
          - bio
          - followers
          - following
          - location
          - site
          - avatar
          properties:
            handle:
              $ref: '#/components/schemas/nullable_string'
            id:
              $ref: '#/components/schemas/nullable_string'
            bio:
              $ref: '#/components/schemas/nullable_string'
            followers:
              $ref: '#/components/schemas/nullable_integer'
            following:
              $ref: '#/components/schemas/nullable_integer'
            location:
              $ref: '#/components/schemas/nullable_string'
            site:
              $ref: '#/components/schemas/nullable_string'
            avatar:
              $ref: '#/components/schemas/nullable_string'
        crunchbase:
          $ref: '#/components/schemas/social_handle'
        youtube:
          $ref: '#/components/schemas/social_handle'
        instagram:
          $ref: '#/components/schemas/social_handle'
        emailsCount:
          $ref: '#/components/schemas/discover_email_counts'
        emailProvider:
          $ref: '#/components/schemas/nullable_string'
        type:
          $ref: '#/components/schemas/nullable_string'
        companyType:
          $ref: '#/components/schemas/nullable_string'
        ticker:
          $ref: '#/components/schemas/nullable_string'
        identifiers:
          type: object
          additionalProperties: false
          required:
          - usEIN
          properties:
            usEIN:
              $ref: '#/components/schemas/nullable_string'
        phone:
          type:
          - string
          - 'null'
          description: Null when claimed for removal or when phone screening is unavailable.
        metrics:
          type: object
          additionalProperties: false
          required:
          - alexaUsRank
          - alexaGlobalRank
          - trafficRank
          - employees
          - employeesCount
          - marketCap
          - raised
          - annualRevenue
          - estimatedAnnualRevenue
          - fiscalYearEnd
          properties:
            alexaUsRank:
              $ref: '#/components/schemas/nullable_integer'
            alexaGlobalRank:
              $ref: '#/components/schemas/nullable_integer'
            trafficRank:
              $ref: '#/components/schemas/nullable_integer'
            employees:
              $ref: '#/components/schemas/nullable_string'
            employeesCount:
              $ref: '#/components/schemas/nullable_integer'
            marketCap:
              $ref: '#/components/schemas/nullable_integer'
            raised:
              type:
              - number
              - 'null'
            annualRevenue:
              $ref: '#/components/schemas/nullable_integer'
            estimatedAnnualRevenue:
              $ref: '#/components/schemas/nullable_integer'
            fiscalYearEnd:
              $ref: '#/components/schemas/nullable_string'
        indexedAt:
          $ref: '#/components/schemas/nullable_string'
        tech:
          type: array
          items:
            type: string
        techCategories:
          type: array
          items:
            type: string
        fundingRounds:
          type: array
          items:
            type: object
            additionalProperties: false
            required:
            - date
            - type
            - amount
            - investors
            properties:
              date:
                type: string
                format: date
              type:
                $ref: '#/components/schemas/nullable_string'
              amount:
                type: string
              investors:
                type: array
                items:
                  type: string
        alreadySaved:
          type: boolean
        parent:
          type: object
          additionalProperties: false
          required:
          - domain
          properties:
            domain:
              $ref: '#/components/schemas/nullable_string'
        ultimateParent:
          type: object
          additionalProperties: false
          required:
          - domain
          properties:
            domain:
              $ref: '#/components/schemas/nullable_string'
    legacy_error_response:
      type: object
      additionalProperties: false
      required:
      - error
      properties:
        error: {}
  responses:
    Error:
      description: The request could not be completed. A 429 with the error id `restricted_account` means the account is blocked, suspended or delinquent; further requests with the same API key are then rejected before reaching the API for up to 10 minutes, while the account and usage endpoints stay available.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/error_response'
  parameters:
    ApiKey:
      name: api_key
      in: query
      description: Hunter API key. Prefer the X-API-KEY header outside browser links.
      schema:
        type: string
    ClearbitFormat:
      name: clearbit_format
      in: query
      description: When set to any non-empty value, return the Clearbit-compatible response shape.
      schema:
        type: string
        example: 'true'
  securitySchemes:
    apiKeyQuery:
      type: apiKey
      in: query
      name: api_key
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-KEY
    bearerAuth:
      type: http
      scheme: bearer
x-provenance:
  method: harvested
  publisher: Hunter
  source: https://hunter.io/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)