POST/v1/email/person

Person Enrichment API

Enrich an email into a structured person profile.

Send an email address and get back a structured person profile: full name, gender, bio, employment (company, domain, title, role, seniority), geographic location, and social profiles across LinkedIn, Twitter, GitHub, and Facebook. Purpose-built for clean, consistent people data in your CRM.

Full Docs Get API Key — Free $5 Credit $0.03 / call

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/email/personperson$0.03/call

Response

Example response — hit "Send Request" to see a live result

{
  "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
}

Features

✓

Structured person object

Returns firstName, lastName, fullName, gender, and bio in a clean nested object, so your CRM stores consistent people records without parsing.

✓

Employment details

The employment block carries company, domain, title, role, and seniority — the fields sales and recruiting workflows rank leads on.

✓

Geographic data

A geo object with city, state, country, and country code lets you segment and route contacts by location.

✓

Social profiles

LinkedIn, Twitter, GitHub, and Facebook handles come attached, opening extra research and outreach channels.

Use cases

CRM People Records

Enrich contacts into complete, structured person profiles for consistent, searchable CRM data.

Recruiting Research

Build candidate profiles with employment history and social links from just an email.

Lead Routing

Route leads by seniority, role, and location using structured enrichment fields.

Quick start

Copy this snippet and start making calls.

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);

The person enrichment API — an email to a structured profile

The Person Enrichment API expands an email into a clean, structured person profile: name, gender, bio, employment, location, and social handles across LinkedIn, Twitter, GitHub, and Facebook. It's the consistent people data layer for your CRM and recruiting tools.

At $0.03 per call it's a fraction of Clearbit's person enrichment, with $5 of free credit and no minimums. Need the company too? The Combined Enrichment endpoint returns both person and company in one call under the same key.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

Get API Key — Free $5 Credit

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
Marcus T.
SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
Priya S.
Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Jake R.
Indie Hacker

Frequently asked questions

Each API call costs $0.03. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/email/person. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.