Email API
Person Enrichment
Turn an email address into a structured person profile — name, employment, location, and social handles.
POST
$0.03/call/v1/email/personUsage
const res = await fetch('https://api.yepapi.com/v1/email/person', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ email: '[email protected]' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/email/person \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
email | string | Yes | Email address of the person to enrich | — |
Response
{
"data": {
"person": {
"bio": null,
"email": "[email protected]",
"employment": {
"company": "Stripe",
"domain": "stripe.com",
"role": null,
"seniority": null,
"title": null
},
"firstName": "Matthew",
"fullName": "Matthew Yalowitz",
"gender": "male",
"geo": {
"city": null,
"country": "United States",
"countryCode": "US",
"state": null
},
"lastName": "Yalowitz",
"location": "US",
"social": {
"facebook": null,
"github": null,
"linkedin": "https://www.linkedin.com/in/myalowitz",
"twitter": null
}
}
},
"ok": true
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.person | object | The structured person profile |
data.person.email | string | The email address that was enriched |
data.person.firstName | string | null | First name |
data.person.lastName | string | null | Last name |
data.person.fullName | string | null | Full name |
data.person.gender | string | null | Inferred gender |
data.person.bio | string | null | Short biography, when available |
data.person.location | string | null | Location string |
data.person.employment | object | Current employment — company, domain, title, role, seniority |
data.person.geo | object | Geographic details — city, state, country, countryCode |
data.person.social | object | Social profiles — facebook, github, linkedin, twitter |
Under the Hood
Need the employer's details too? Combined Enrichment returns this person profile plus a full company profile in a single call.