# hunter.email.find

Email for a named person at a company domain, with score

> This API endpoint finds the most likely email address from a domain name, a first name and a last name.

Page: https://telipot.com/catalog/tasks/hunter.email.find · Markdown: https://telipot.com/catalog/tasks/hunter.email.find/md · JSON: https://telipot.com/catalog/tasks/hunter.email.find/json

| Field | Value |
| --- | --- |
| provider | [Hunter](https://telipot.com/catalog/providers/hunter) `hunter` |
| capability | [`email.find`](https://telipot.com/catalog/capabilities/email.find) |
| kind | data |
| tier | core |
| price | $0.0245 / email (1 credit · docs) |
| price 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. |
| identity | Your plan |
| auth | `api_key · in header as X-API-KEY` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `GET https://api.hunter.io/v2/email-finder` |
| verification | Untestable. Needs a specific person's name or LinkedIn handle and answers with that person's email address and employer. |
| status | live |
| docs | https://hunter.io/api-documentation/v2#email-finder |

## Inspect first

No complete example input is recorded. Read the schema and field notes before building the call.

```bash
telipot inspect hunter.email.find
```

```bash
curl https://api.telipot.com/v1/tasks/hunter.email.find \
  -H "Authorization: Bearer $TELIPOT_TOKEN"
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `domain` | queryParams | string | no |  | Company domain. Give domain, company or linkedin_handle. A URL or a leading @ is reduced to the domain. |
| `company` | queryParams | string | no |  | Company name, used when the domain is unknown. A domain gives better results; domain wins when both are given. |
| `linkedin_handle` | queryParams | string | no |  | LinkedIn profile handle. With it no name is needed. |
| `first_name` | queryParams | string | no |  | With last_name, required unless full_name or linkedin_handle is given. |
| `last_name` | queryParams | string | no |  | With first_name, required unless full_name or linkedin_handle is given. |
| `full_name` | queryParams | string | no |  | Required unless first_name and last_name, or linkedin_handle, is given. First and last name give better results. |
| `max_duration` | queryParams | integer | no | 3 to 20; default 10 | Seconds the lookup may run. A longer time lets Hunter refine the result. |

## Input schema

```json
{
  "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 schema

```json
{
  "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"
        }
      }
    }
  }
}
```