POST/v1/email/locations

Employee Locations API

See where a company's employees are located by country.

Return a breakdown of a company's discoverable employees by country, each with a headcount. Use it to understand a company's geographic footprint, target the right region for outreach, and comply with location-based sending rules.

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/locationslocations$0.01/call

Response

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

{
  "data": {
    "locations": [
      {
        "count": 4015,
        "country": "US"
      },
      {
        "count": 116,
        "country": "IE"
      },
      {
        "count": 17,
        "country": "SG"
      },
      {
        "count": 16,
        "country": "GB"
      },
      {
        "count": 16,
        "country": "CA"
      },
      {
        "count": 10,
        "country": "AU"
      },
      {
        "count": 9,
        "country": "FR"
      },
      {
        "count": 7,
        "country": "JP"
      },
      {
        "count": 4,
        "country": "IN"
      },
      {
        "count": 4,
        "country": "DE"
      }
    ]
  },
  "ok": true
}

Features

✓

Country-level headcount

Each entry pairs an ISO country code with the number of employees found there, giving you a clear map of where a company's people are.

✓

Geographic footprint at a glance

See whether an account is concentrated in one market or spread globally before you plan territory or timezone-aware outreach.

✓

Compliance targeting

Identify which regions a company operates in to align outreach with location-based consent and sending rules.

✓

One-cent lookups

At $0.01 per domain, run it across a list to segment accounts by geography cheaply.

Use cases

Territory Assignment

Route accounts to the right regional sales rep based on where the company's employees actually sit.

Timezone-Aware Outreach

Schedule campaigns for the country where most of a company's contacts are located.

Market Research

Map the geographic distribution of companies in a segment to size regional opportunity.

Quick start

Copy this snippet and start making calls.

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

The employee locations API — a company's geographic footprint

The Employee Locations API returns a company's discoverable employees grouped by country, each with a headcount. It reveals where an account's people actually sit — essential for territory assignment, timezone-aware campaigns, and region-based compliance.

At $0.01 per domain with $5 of free credit and no minimums, it's a cheap segmentation signal you can run across an entire account list, 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/locations. 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.