# hunter.email.domain.count

Count of emails on file for a domain, by type and department

> This API endpoint allows you to know how many email addresses we have for one domain or for one company.

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

| Field | Value |
| --- | --- |
| provider | [Hunter](https://telipot.com/catalog/providers/hunter) `hunter` |
| capability | [`email.domain.count`](https://telipot.com/catalog/capabilities/email.domain.count) |
| 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/email-count` |
| 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#email-count |

## Preview the price · nothing runs

```bash
telipot run hunter.email.domain.count \
  --input-json '{"domain":"stripe.com"}' \
  --quote
```

## Run it

```bash
telipot run hunter.email.domain.count \
  --input-json '{"domain":"stripe.com"}'
```

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

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `domain` | queryParams | string | no |  | Domain to count. Give domain or company; domain wins when both are given. |
| `company` | queryParams | string | no |  | Company name, used when the domain is unknown. At least 3 characters. |
| `type` | queryParams | string | no | one of "personal", "generic" | Count only personal addresses, or only role-based (generic) ones. |
| `include_job_titles` | queryParams | string | no |  | Any non-empty value adds data.job_titles, counts by job title. Listed in Hunter's OpenAPI, not on the docs page. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to count. Give domain or company; domain wins when both are given.",
      "examples": [
        "stripe.com"
      ]
    },
    "company": {
      "type": "string",
      "description": "Company name, used when the domain is unknown. At least 3 characters.",
      "examples": [
        "stripe"
      ]
    },
    "type": {
      "type": "string",
      "description": "Count only personal addresses, or only role-based (generic) ones.",
      "enum": [
        "personal",
        "generic"
      ]
    },
    "include_job_titles": {
      "type": "string",
      "description": "Any non-empty value adds data.job_titles, counts by job title. Listed in Hunter's OpenAPI, not on the docs page.",
      "examples": [
        "1"
      ]
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "total",
        "personal_emails",
        "generic_emails",
        "department",
        "seniority"
      ],
      "properties": {
        "total": {
          "type": "integer"
        },
        "personal_emails": {
          "type": "integer"
        },
        "generic_emails": {
          "type": "integer"
        },
        "department": {
          "type": "object",
          "description": "Counts by department. Only emails with a known department are counted, so the sum can be below total.",
          "additionalProperties": {
            "type": "integer"
          }
        },
        "seniority": {
          "type": "object",
          "description": "Counts by seniority. Only emails with a known seniority are counted, so the sum can be below total.",
          "additionalProperties": {
            "type": "integer"
          }
        },
        "job_titles": {
          "type": "object",
          "additionalProperties": {
            "type": "integer"
          }
        }
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "params": {
          "type": "object"
        }
      }
    }
  }
}
```