# hunter.people.enrich

Person profile from an email or LinkedIn handle, with role

> Returns all the information associated with an email address or LinkedIn handle, such as a person's name, location and social handles.

Page: https://telipot.com/catalog/tasks/hunter.people.enrich · Markdown: https://telipot.com/catalog/tasks/hunter.people.enrich/md · JSON: https://telipot.com/catalog/tasks/hunter.people.enrich/json

| Field | Value |
| --- | --- |
| provider | [Hunter](https://telipot.com/catalog/providers/hunter) `hunter` |
| capability | [`people.enrich`](https://telipot.com/catalog/capabilities/people.enrich) |
| kind | data |
| tier | core |
| price | $0.0049 / email (0.2 credits · docs) |
| price note | All-in-one plans: 0.2 credit per enriched email or domain. Data Platform plans: 1 Search credit. The credit article does not say whether a 404 (nothing found) or a 451 (person asked not to be processed) is charged; it prices an enriched item, so both are treated as free. |
| 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/people/find` |
| verification | Untestable. Needs a specific person's email address or LinkedIn handle and answers with that person's name, location, employer and social profiles. |
| status | live |
| docs | https://hunter.io/api-documentation/v2#email-enrichment |

## Inspect first

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

```bash
telipot inspect hunter.people.enrich
```

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

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `email` | queryParams | string | no |  | Email address to enrich. Give email or linkedin_handle; linkedin_handle wins when both are given. |
| `linkedin_handle` | queryParams | string | no |  | LinkedIn profile handle to enrich. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address to enrich. Give email or linkedin_handle; linkedin_handle wins when both are given."
    },
    "linkedin_handle": {
      "type": "string",
      "description": "LinkedIn profile handle to enrich."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "id",
        "email"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "object",
          "properties": {
            "fullName": {
              "type": [
                "string",
                "null"
              ]
            },
            "givenName": {
              "type": [
                "string",
                "null"
              ]
            },
            "familyName": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "email": {
          "type": "string"
        },
        "location": {
          "type": [
            "string",
            "null"
          ]
        },
        "timeZone": {
          "type": [
            "string",
            "null"
          ]
        },
        "geo": {
          "type": "object",
          "properties": {
            "city": {
              "type": [
                "string",
                "null"
              ]
            },
            "state": {
              "type": [
                "string",
                "null"
              ]
            },
            "country": {
              "type": [
                "string",
                "null"
              ]
            },
            "countryCode": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "bio": {
          "type": [
            "string",
            "null"
          ]
        },
        "site": {
          "type": [
            "string",
            "null"
          ]
        },
        "avatar": {
          "type": [
            "string",
            "null"
          ]
        },
        "employment": {
          "type": "object",
          "properties": {
            "domain": {
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "role": {
              "type": [
                "string",
                "null"
              ]
            },
            "subRole": {
              "type": [
                "string",
                "null"
              ]
            },
            "seniority": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "linkedin": {
          "type": "object",
          "properties": {
            "handle": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "twitter": {
          "type": "object",
          "properties": {
            "handle": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "github": {
          "type": "object",
          "properties": {
            "handle": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "phone": {
          "type": [
            "string",
            "null"
          ]
        },
        "fuzzy": {
          "type": "boolean"
        }
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string"
        }
      }
    }
  }
}
```

## Other tools for this job

- [`apollo.people.enrich`](https://telipot.com/catalog/tasks/apollo.people.enrich) · $0.0196 / call