Email API
Email Count
Get the number of email addresses available for a domain, broken down by department and seniority.
POST
$0.01/call/v1/email/countUsage
const res = await fetch('https://api.yepapi.com/v1/email/count', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ domain: 'stripe.com' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/email/count \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "stripe.com"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
domain | string | Yes | Domain to count emails for (e.g., stripe.com) | — |
Response
{
"data": {
"byDepartment": {
"accounting": 27,
"administrative": 14,
"communication": 14,
"diversity": 2,
"education": 6,
"engineering": 284,
"executive": 112,
"facilities": 2,
"finance": 119,
"healthcare": 0,
"hr": 81,
"it": 102,
"legal": 39,
"management": 259,
"marketing": 166,
"operations": 159,
"pr": 13,
"sales": 222,
"security": 72,
"software": 584,
"support": 87,
"warehouse": 83
},
"bySeniority": {
"executive": 75,
"junior": 55,
"senior": 307
},
"genericEmails": 213,
"personalEmails": 4852,
"total": 5065
},
"ok": true
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.total | number | Total number of email addresses available for the domain |
data.personalEmails | number | Number of personal (named) email addresses |
data.genericEmails | number | Number of generic addresses (e.g., support@, info@) |
data.byDepartment | object | Email counts keyed by department (e.g., engineering, sales, marketing) |
data.bySeniority | object | Email counts keyed by seniority level (junior, senior, executive) |
Under the Hood
This endpoint is a cheap way to scope a Domain Search before running it — check the counts first, then pull only the departments you need.