Email API
Company Enrichment
Turn a domain into a structured company profile — industry codes, location, size, revenue, emails, and social handles.
POST
$0.03/call/v1/email/companyUsage
const res = await fetch('https://api.yepapi.com/v1/email/company', {
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/company \
-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 enrich (e.g., stripe.com) | — |
Response
{
"data": {
"company": {
"category": {
"industry": null,
"naicsCode": "51",
"sector": null,
"sicCode": "73"
},
"description": "stripe is a payment processing platform enabling businesses to accept payments and manage online transactions.",
"domain": "stripe.com",
"emails": [
"[email protected]",
"[email protected]",
"[email protected]",
"[email protected]",
"[email protected]",
"[email protected]"
],
"foundedYear": "2010",
"geo": {
"city": "San Francisco",
"country": "United States",
"countryCode": "US",
"postalCode": "94107",
"state": "California",
"streetAddress": "354 oyster point blvd"
},
"legalName": "Stripe",
"logo": null,
"metrics": {
"employees": "5K-10K",
"employeesRange": null,
"estimatedAnnualRevenue": "$100M-$250M"
},
"name": "Stripe",
"phones": null,
"social": {
"facebook": "stripehq",
"linkedin": "stripe",
"twitter": "stripe"
}
}
},
"ok": true
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.company | object | The structured company profile |
data.company.name | string | null | Company name |
data.company.legalName | string | null | Registered legal name |
data.company.domain | string | Company domain |
data.company.description | string | null | Short company description |
data.company.foundedYear | string | null | Year the company was founded |
data.company.logo | string | null | Logo URL, when available |
data.company.category | object | Classification — industry, sector, naicsCode, sicCode |
data.company.geo | object | HQ location — streetAddress, city, state, country, countryCode, postalCode |
data.company.metrics | object | Size metrics — employees, employeesRange, estimatedAnnualRevenue |
data.company.emails | string[] | Sample email addresses found on the domain |
data.company.phones | string[] | null | Company phone numbers, when available |
data.company.social | object | Social handles — facebook, linkedin, twitter |
Under the Hood
naicsCode and sicCode are standard industry classification codes — handy for firmographic segmentation and CRM enrichment.