{
  "url": "https://telipot.com/catalog/capabilities/email.find",
  "id": "email.find",
  "description": "Email address of a named person at a company domain",
  "platform": "email",
  "providers": [
    {
      "slug": "hunter",
      "name": "Hunter"
    }
  ],
  "tasks": 1,
  "taskPages": [
    {
      "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": []
    }
  ]
}