{
  "url": "https://telipot.com/catalog/tasks/hunter.people.enrich",
  "id": "hunter.people.enrich",
  "name": "Person profile from an email or LinkedIn handle, with role",
  "provider": {
    "slug": "hunter",
    "name": "Hunter"
  },
  "capability": "people.enrich",
  "platform": "people",
  "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: 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.",
    "state": "paid",
    "label": "$0.0049 / email",
    "amount": "$0.0049",
    "unit": "email",
    "usdPerUnit": {
      "floor": 0.0049,
      "ceiling": 0.0049
    },
    "native": {
      "text": "0.2 credits per email",
      "figure": "0.2 credits",
      "per": "email",
      "currency": "credits"
    },
    "detail": "0.2 credits · docs"
  },
  "providers": 2,
  "retention": "standard",
  "runsOn": "byoc",
  "live": true,
  "summary": "Returns all the information associated with an email address or LinkedIn handle, such as a person's name, location and social handles.",
  "method": "GET",
  "path": "/people/find",
  "host": "https://api.hunter.io/v2",
  "docsUrl": "https://hunter.io/api-documentation/v2#email-enrichment",
  "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 email address or LinkedIn handle and answers with that person's name, location, employer and social profiles."
  },
  "input": [
    {
      "name": "email",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Email address to enrich. Give email or linkedin_handle; linkedin_handle wins when both are given."
    },
    {
      "name": "linkedin_handle",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "LinkedIn profile handle to enrich."
    }
  ],
  "sampleInput": {},
  "inputSchema": {
    "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": [
    {
      "name": "data",
      "type": "object"
    },
    {
      "name": "meta",
      "type": "object"
    }
  ],
  "outputSchema": {
    "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"
          }
        }
      }
    }
  },
  "commands": {
    "mode": "inspect",
    "cli": "telipot inspect hunter.people.enrich",
    "http": "curl https://api.telipot.com/v1/tasks/hunter.people.enrich \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\""
  },
  "siblings": [
    {
      "id": "apollo.people.enrich",
      "name": "Person's title, work email from email, LinkedIn URL or name",
      "provider": {
        "slug": "apollo",
        "name": "Apollo"
      },
      "capability": "people.enrich",
      "platform": "people",
      "kind": "data",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "type": "per_success",
        "confidence": "documented",
        "source": "docs",
        "sourceUrl": "https://docs.apollo.io/docs/api-pricing",
        "checked": "2026-10-05",
        "note": "1 credit when credit-consuming data (demographics or email) is found, 0 when none is. The docs give 1-9 credits per person: +8 when a mobile phone is returned, and waterfall enrichment costs more. This task sends no phone, personal-email or waterfall option, so it is priced at the 1-credit base.",
        "state": "paid",
        "label": "$0.0196 / call",
        "amount": "$0.0196",
        "unit": "call",
        "usdPerUnit": {
          "floor": 0.0196,
          "ceiling": 0.0196
        },
        "native": {
          "text": "1 credit per call",
          "figure": "1 credit",
          "per": "call",
          "currency": "credits"
        },
        "detail": "1 credit · docs"
      },
      "providers": 2,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true
    }
  ]
}