Email API
Employee Locations
See where a company's employees are located — email contact counts broken down by country.
POST
$0.01/call/v1/email/locationsUsage
const res = await fetch('https://api.yepapi.com/v1/email/locations', {
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/locations \
-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 | Company domain to get employee locations for (e.g., stripe.com) | — |
Response
{
"data": {
"locations": [
{
"count": 4,
"country": "IN"
},
{
"count": 1,
"country": "HK"
},
{
"count": 2,
"country": "NL"
},
{
"count": 1,
"country": "GH"
},
{
"count": 1,
"country": "MY"
},
{
"count": 116,
"country": "IE"
},
{
"count": 16,
"country": "GB"
},
{
"count": 2,
"country": "ES"
},
{
"count": 4,
"country": "DE"
},
{
"count": 1,
"country": "SE"
},
{
"count": 10,
"country": "AU"
},
{
"count": 16,
"country": "CA"
},
{
"count": 9,
"country": "FR"
},
{
"count": 4015,
"country": "us"
},
{
"count": 1,
"country": "NO"
},
{
"count": 1,
"country": "IT"
},
{
"count": 4015,
"country": "US"
},
{
"count": 7,
"country": "JP"
},
{
"count": 1,
"country": "JM"
},
{
"count": 1,
"country": "TW"
},
{
"count": 17,
"country": "SG"
},
{
"count": 1,
"country": "PH"
}
]
},
"ok": true
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.locations | object[] | Employee contact counts per country |
data.locations[].country | string | ISO 3166-1 alpha-2 country code |
data.locations[].count | number | Number of employee contacts located in that country |
Under the Hood
Country codes may appear in mixed case (e.g., both us and US) — normalize casing and merge counts on your side if you need a strict per-country total.