POST/v1/email/count

Email Count API

Count emails on a domain by department and seniority.

Get the number of discoverable emails on a company domain, broken down by department and seniority, plus totals for personal versus generic addresses. A cheap way to size an account and plan a search before spending on full contact retrieval.

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

Try it live

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

POST/v1/email/countcount$0.01/call

Response

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

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

Features

✓

Total email count for a domain

One number tells you how many addresses are discoverable on a company, so you can gauge the depth of an account instantly.

✓

Department breakdown

Counts split across 20+ departments — engineering, sales, marketing, finance, HR, and more — reveal where an organization's headcount and contacts sit.

✓

Seniority breakdown

Executive, senior, and junior counts help you judge whether a domain holds the decision makers you need before you search.

✓

Personal vs generic split

Separate personalEmails and genericEmails totals distinguish real people from role addresses like info@ and support@.

Use cases

Account Sizing

Estimate how many reachable contacts a target company has before committing budget to a full domain search.

Territory Planning

Compare email counts across a list of accounts to prioritize the richest targets for sales.

Search Budgeting

Use department counts to decide which segments are worth retrieving in full.

Quick start

Copy this snippet and start making calls.

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

The email count API — size a domain by department and seniority

The Email Count API returns how many emails are discoverable on a company domain, broken out by department and seniority with a personal-versus-generic split. It's the reconnaissance step before a full search — size the account and see where its people sit for a single cent.

At $0.01 a call with $5 of free credit and no minimums, it's a cheap way to prioritize accounts and budget your domain searches, all under one YepAPI 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.01. 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/count. 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.