Skip to main content
The Employee Finder endpoint (POST /v2/search/employee-finder) lets you search for employees within a specific company using structured filters: job level, department, geography, and more. Unlike Waterfall ICP Search which uses a priority cascade to find the best contact, Employee Finder returns all matching employees with pagination — ideal for broad team mapping and multi-threaded outreach. Paid plans: Unlimited — included in your flat monthly subscription.

​
When to Use Employee Finder vs. Other Endpoints

Use CaseBest Endpoint
Find the single best decision-maker at a companyWaterfall ICP
Map all VPs and Directors in the Sales departmentEmployee Finder
Build a buying committee with strict priority orderWaterfall ICP
Export the full engineering team for hiring intelligenceEmployee Finder
Get paginated results across large companiesEmployee Finder

​
Request Parameters

​
Top-Level Parameters

ParameterTypeRequiredDefaultDescription
company_linkedin_urlstringYes—The full LinkedIn URL of the target company.
country_codearrayNo["WORLD"]Filter by country (2-letter ISO codes). Use ["WORLD"] for global.
continentarrayNo—Filter by continent. See accepted values.
sales_regionarrayNo—Filter by sales region. See accepted values.
job_levelarrayNo—Filter by seniority level. See accepted values.
job_functionarrayNo—Filter by department/function. See accepted values.
min_connections_countnumberNo0Minimum LinkedIn connections (0–500). Useful to filter out inactive profiles.
max_resultsnumberNo50Results per page. Min: 1, Max: 50.
pagenumberNo1Page number for pagination. Starts at 1.
All filter values (job_level, job_function, sales_region, continent) are case-sensitive enums. Passing "vp" instead of "VP" or "sales" instead of "Sales & Business Development" will silently return 0 results. Copy-paste from the Field Normalization reference.

​
Example Request

Find all Directors and VPs in Sales & Marketing at OpenAI, in North America: 
curl -X POST "https://api.blitz-api.ai/v2/search/employee-finder" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/openai",
    "job_level": ["VP", "Director"],
    "job_function": ["Sales & Business Development", "Advertising & Marketing"],
    "sales_region": ["NORAM"],
    "max_results": 10,
    "page": 1
  }'

​
Response Schema

{
  "company_linkedin_url": "https://www.linkedin.com/company/openai",
  "max_results": 10,
  "results_length": 10,
  "page": 1,
  "total_pages": 24,
  "results": [
    {
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "nickname": null,
      "civility_title": "Ms",
      "headline": "VP of Sales at OpenAI",
      "about_me": "Experienced sales leader...",
      "location": {
        "city": "San Francisco",
        "state_code": "CA",
        "country_code": "US",
        "continent": "North America"
      },
      "linkedin_url": "https://www.linkedin.com/in/janedoe",
      "connections_count": 2500,
      "profile_picture_url": "https://media.licdn.com/...",
      "experiences": [
        {
          "job_title": "VP of Sales",
          "company_linkedin_url": "https://www.linkedin.com/company/openai",
          "company_linkedin_id": "88888888",
          "job_description": "Leading the global sales team...",
          "job_start_date": "2024-01-15",
          "job_end_date": null,
          "job_is_current": true,
          "job_location": {
            "city": "San Francisco",
            "state_code": "CA",
            "country_code": "US"
          }
        }
      ],
      "education": [
        {
          "school_name": "Stanford University",
          "degree": "MBA",
          "field_of_study": "Business Administration",
          "start_date": "2016-09-01",
          "end_date": "2018-06-01"
        }
      ],
      "skills": ["Sales Strategy", "B2B", "SaaS"],
      "certifications": []
    }
  ]
}

​
Top-Level Response Fields

FieldTypeDescription
company_linkedin_urlstringThe company queried.
max_resultsnumberThe max_results value you sent.
results_lengthnumberNumber of results on this page.
pagenumberCurrent page number.
total_pagesnumberTotal number of pages available. Use to know when to stop paginating.
resultsarrayArray of person profiles.

​
Person Fields (results[])

FieldTypeDescription
first_namestring | nullFirst name.
last_namestring | nullLast name.
full_namestring | nullFull display name.
nicknamestring | nullNickname / preferred name.
civility_titlestring | nullTitle (e.g., “Mr”, “Ms”, “Dr”).
headlinestring | nullLinkedIn headline.
about_mestring | nullLinkedIn “About” section text.
locationobjectPerson location: city, state_code, country_code, continent.
linkedin_urlstringPerson LinkedIn URL. Use this as input for email/phone enrichment.
connections_countnumber | nullLinkedIn connections count.
profile_picture_urlstring | nullURL to the profile picture.
experiencesarrayWork history (see below).
educationarray | nullEducation history (see below).
skillsarray | nullList of skills (strings).
certificationsarray | nullList of certifications. Each entry has name, authority, url.

​
Experience Fields (results[].experiences[])

FieldTypeDescription
job_titlestring | nullJob title.
company_linkedin_urlstring | nullCompany LinkedIn URL.
company_linkedin_idstring | nullCompany LinkedIn numeric ID.
job_descriptionstring | nullJob description text.
job_start_datestring | nullStart date (format: YYYY-MM-DD).
job_end_datestring | nullEnd date (null if current role).
job_is_currentboolean | nullWhether this is the current role.
job_locationobjectJob location: city, state_code, country_code.

​
Education Fields (results[].education[])

FieldTypeDescription
school_namestringName of the school or university.
degreestringDegree obtained.
field_of_studystringField of study / major.
start_datestringStart date.
end_datestringEnd date.
Key difference from Waterfall ICP: Employee Finder return person fields directly in results[]. Waterfall ICP nests them inside results[].person. Plan your parsing logic accordingly.

​
Pagination

Employee Finder supports page-based pagination. Each response includes page and total_pages. 
// Paginate through all results
let page = 1;
let totalPages = 1;

do {
  const result = await blitzRequest("POST", "/v2/search/employee-finder", {
    company_linkedin_url: "https://www.linkedin.com/company/openai",
    job_level: ["VP", "Director"],
    max_results: 50,
    page: page,
  });

  totalPages = result.total_pages;

  for (const person of result.results) {
    console.log(`${person.full_name} — ${person.headline}`);
  }

  page++;
} while (page <= totalPages);

​
Combining with Enrichment

Employee Finder returns LinkedIn profile URLs but not emails or phone numbers. Chain with enrichment endpoints to complete the data:
1

Search employees

Use Employee Finder to get linkedin_url for each matching person.
2

Enrich emails

Pass each linkedin_url to POST /v2/enrichment/email to get verified work emails.
3

Enrich phones (US only)

Pass each linkedin_url to POST /v2/enrichment/phone for direct mobile numbers.
4

Validate and sync

Validate emails via POST /v2/utilities/email/validate, then sync clean data to your CRM.

Waterfall ICP Search

Need the single best contact? Use Waterfall instead.

Field Normalization

Full list of accepted values for job_level, job_function, and sales_region.