# hunter.company.domain.find

Domain candidates for a company name, with email counts

> This API endpoint returns the most likely domain name(s) for a given company name.

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

| Field | Value |
| --- | --- |
| provider | [Hunter](https://telipot.com/catalog/providers/hunter) `hunter` |
| capability | [`company.domain.find`](https://telipot.com/catalog/capabilities/company.domain.find) |
| kind | data |
| tier | core |
| price | Free (Free from the tool) |
| 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/domain-finder` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://hunter.io/api-documentation/v2#domain-finder |

## Preview the price · nothing runs

```bash
telipot run hunter.company.domain.find \
  --input-json '{"company":"stripe","limit":1}' \
  --quote
```

## Run it

```bash
telipot run hunter.company.domain.find \
  --input-json '{"company":"stripe","limit":1}'
```

```bash
curl https://api.telipot.com/v1/tasks/hunter.company.domain.find/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"company":"stripe","limit":1}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `company` | queryParams | string | yes | at least 3 | Company name to resolve, at least 3 characters. |
| `limit` | queryParams | integer | no | 1 to 10; default 5 | Maximum suggestions returned. |
| `perfect_match` | queryParams | boolean | no | default false | true returns only suggestions very similar to the name, for one confident answer instead of a list. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Company name to resolve, at least 3 characters.",
      "examples": [
        "stripe"
      ],
      "minLength": 3
    },
    "limit": {
      "type": "integer",
      "description": "Maximum suggestions returned.",
      "default": 5,
      "minimum": 1,
      "maximum": 10
    },
    "perfect_match": {
      "type": "boolean",
      "description": "true returns only suggestions very similar to the name, for one confident answer instead of a list.",
      "default": false
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "domain",
          "company_name"
        ],
        "properties": {
          "domain": {
            "type": "string"
          },
          "company_name": {
            "type": "string"
          },
          "logo": {
            "type": "string"
          },
          "email_count": {
            "type": "integer",
            "description": "Emails Hunter holds for the domain; 0 can mean a privacy-suppressed domain"
          }
        }
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "results": {
          "type": "integer"
        },
        "params": {
          "type": "object"
        }
      }
    }
  }
}
```