Search

People by Domains

Find people at companies by their domains.

How it works:

  1. Provide a list of company domains (up to 1000) and job titles to search for
  2. The system finds companies by domains
  3. Returns up to people_per_company people per found company with matching job titles

Job title matching:

  • Uses semantic search: "Head of Sales" will match "VP Sales", "Sales Director", etc.
  • Multiple job titles are combined with OR logic

Parameters:

  • people_per_company: Number of people to return per company (1-1000, default: 1)

Limits:

  • Maximum 1000 domains per request
  • Maximum 20 job titles per request
  • Maximum 1000 people per company
  • Maximum 10000 people per response (total)

Billing:

  • 1 credit per person returned

Deduplication:

  • Pass dedup list ids in exclude_lists — matched people are not returned and not charged
post/public/api/v1/search/people-by-domains

Request

  • Base URL: https://api.explee.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.explee.com/public/api/v1/search/people-by-domains
  • Auth: APIKeyHeader (a scheme the document does not define)

Request body

domainsstring[] required

List of company domains (max 1000). Each domain will be normalized.

job_titlesstring[] required

Job titles to search for (max 20, OR logic). Supports semantic matching.

people_per_companyinteger

Number of people to return per company (1-1000). Default: 1.

exclude_listsstring[] nullable

Ids of your dedup lists (see Deduplication endpoints). Results already present in these lists are excluded and never charged. People endpoints also accept companies lists: every person at a listed domain is excluded. When set, the free results zone does not apply. Max 100 lists / 500000 values combined per request.

Example request

{
  "domains": [
    "bmw.com",
    "mercedes-benz.com",
    "audi.com"
  ],
  "job_titles": [
    "Head of Sales",
    "VP Marketing"
  ],
  "people_per_company": 3
}

Response

Successful Response

successboolean

Always true for successful requests.

Example response

{
  "success": true,
  "people": [
    {
      "first_name": "John",
      "last_name": "Smith",
      "title": "Head of Sales",
      "headline": "Sales Leader | B2B SaaS",
      "linkedin_url": "https://linkedin.com/in/johnsmith",
      "geo": "US",
      "follower_count": 1234,
      "company_name": "Acme Inc",
      "company_domain": "acme.com",
      "company_url": "https://acme.com",
      "company_linkedin_id": 12345678,
      "company_size": "51-200",
      "company_geo": "US",
      "company_city": "San Francisco",
      "company_industry": "IT Services and IT Consulting",
      "company_industries_nace": [
        {
          "code": "J63.1.2",
          "description": "Web portals",
          "sector": "Information and communication"
        }
      ],
      "company_founded": 2015,
      "company_traffic": 25000000,
      "company_traffic_growth": 0.12,
      "company_web_metrics_bounce_rate": 0.41,
      "company_web_metrics_pages_per_visit": 3.2,
      "company_web_metrics_time_on_site": 185.5,
      "company_marketing_pixels": [
        "google_ads",
        "meta",
        "linkedin"
      ],
      "company_revenue_annual": 100000000,
      "company_geo_country_employees": {
        "GB": 56,
        "IN": 100,
        "US": 1080,
        "total": 1555
      },
      "company_geo_founders": [
        "US",
        "IN"
      ],
      "company_geo_countries": {
        "DE": 15,
        "GB": 25,
        "US": 60
      },
      "company_geo_countries_traffic": {
        "HK": 3.13,
        "IN": 6.71,
        "US": 30.39
      },
      "company_employees_by_department": {
        "employees_count_sales": 7,
        "employees_count_technical": 316
      },
      "criteria": {
        "Has lead gen experience": {
          "reasoning": "Profile mentions 5+ years in lead generation",
          "score": 4
        }
      },
      "match": 3
    }
  ],
  "meta": {
    "total": 12500,
    "results_count": 100,
    "credits_charged": 50,
    "remaining_balance": 950,
    "excluded_total": 37
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.