{
  "url": "https://telipot.com/catalog/tasks/hunter.email.find",
  "id": "hunter.email.find",
  "name": "Email for a named person at a company domain, with score",
  "provider": {
    "slug": "hunter",
    "name": "Hunter"
  },
  "capability": "email.find",
  "platform": "email",
  "kind": "data",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "type": "per_success",
    "confidence": "documented",
    "source": "docs",
    "sourceUrl": "https://help.hunter.io/en/articles/1911617-how-do-credits-work-in-hunter",
    "checked": "2026-10-05",
    "note": "All-in-one plans: 1 credit per email found, none when no email is found, and a repeat of the same search in one billing period is not charged again. Data Platform plans: 1 Search credit per email.",
    "state": "paid",
    "label": "$0.0245 / email",
    "amount": "$0.0245",
    "unit": "email",
    "usdPerUnit": {
      "floor": 0.0245,
      "ceiling": 0.0245
    },
    "native": {
      "text": "1 credit per email",
      "figure": "1 credit",
      "per": "email",
      "currency": "credits"
    },
    "detail": "1 credit · docs"
  },
  "providers": 1,
  "retention": "standard",
  "runsOn": "byoc",
  "live": true,
  "summary": "This API endpoint finds the most likely email address from a domain name, a first name and a last name.",
  "method": "GET",
  "path": "/email-finder",
  "host": "https://api.hunter.io/v2",
  "docsUrl": "https://hunter.io/api-documentation/v2#email-finder",
  "auth": {
    "scheme": "api_key",
    "label": "api_key · in header as X-API-KEY",
    "short": "api_key · x-api-key"
  },
  "scope": "any_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "untestable",
    "label": "Untestable",
    "detail": "Needs a specific person's name or LinkedIn handle and answers with that person's email address and employer."
  },
  "input": [
    {
      "name": "domain",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Company domain. Give domain, company or linkedin_handle. A URL or a leading @ is reduced to the domain."
    },
    {
      "name": "company",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Company name, used when the domain is unknown. A domain gives better results; domain wins when both are given."
    },
    {
      "name": "linkedin_handle",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "LinkedIn profile handle. With it no name is needed."
    },
    {
      "name": "first_name",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "With last_name, required unless full_name or linkedin_handle is given."
    },
    {
      "name": "last_name",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "With first_name, required unless full_name or linkedin_handle is given."
    },
    {
      "name": "full_name",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Required unless first_name and last_name, or linkedin_handle, is given. First and last name give better results."
    },
    {
      "name": "max_duration",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [
        "3 to 20",
        "default 10"
      ],
      "note": "Seconds the lookup may run. A longer time lets Hunter refine the result."
    }
  ],
  "sampleInput": {},
  "inputSchema": {
    "type": "object",
    "properties": {
      "domain": {
        "type": "string",
        "description": "Company domain. Give domain, company or linkedin_handle. A URL or a leading @ is reduced to the domain.",
        "examples": [
          "reddit.com"
        ]
      },
      "company": {
        "type": "string",
        "description": "Company name, used when the domain is unknown. A domain gives better results; domain wins when both are given.",
        "examples": [
          "reddit"
        ]
      },
      "linkedin_handle": {
        "type": "string",
        "description": "LinkedIn profile handle. With it no name is needed."
      },
      "first_name": {
        "type": "string",
        "description": "With last_name, required unless full_name or linkedin_handle is given."
      },
      "last_name": {
        "type": "string",
        "description": "With first_name, required unless full_name or linkedin_handle is given."
      },
      "full_name": {
        "type": "string",
        "description": "Required unless first_name and last_name, or linkedin_handle, is given. First and last name give better results."
      },
      "max_duration": {
        "type": "integer",
        "description": "Seconds the lookup may run. A longer time lets Hunter refine the result.",
        "default": 10,
        "minimum": 3,
        "maximum": 20
      }
    },
    "additionalProperties": false
  },
  "output": [
    {
      "name": "data",
      "type": "object"
    },
    {
      "name": "meta",
      "type": "object"
    }
  ],
  "outputSchema": {
    "type": "object",
    "required": [
      "data",
      "meta"
    ],
    "properties": {
      "data": {
        "type": "object",
        "required": [
          "first_name",
          "last_name",
          "email",
          "score",
          "domain",
          "accept_all",
          "position",
          "linkedin_url",
          "company",
          "sources",
          "verification"
        ],
        "properties": {
          "first_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ]
          },
          "score": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Estimated probability, 0 to 100, that the address is correct"
          },
          "domain": {
            "type": [
              "string",
              "null"
            ]
          },
          "accept_all": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "position": {
            "type": [
              "string",
              "null"
            ]
          },
          "twitter": {
            "type": [
              "string",
              "null"
            ]
          },
          "linkedin_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "phone_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "found or generated"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "domain": {
                  "type": "string"
                },
                "uri": {
                  "type": "string"
                },
                "extracted_on": {
                  "type": "string"
                },
                "last_seen_on": {
                  "type": "string"
                },
                "still_on_page": {
                  "type": "boolean"
                }
              }
            }
          },
          "verification": {
            "type": "object",
            "properties": {
              "date": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "valid, accept_all or unknown"
              }
            }
          }
        }
      },
      "meta": {
        "type": "object",
        "properties": {
          "params": {
            "type": "object"
          }
        }
      }
    }
  },
  "commands": {
    "mode": "inspect",
    "cli": "telipot inspect hunter.email.find",
    "http": "curl https://api.telipot.com/v1/tasks/hunter.email.find \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\""
  },
  "siblings": []
}