> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blitz-api.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Employee Finder
> Search all employees at a single company by job level, department, location, and seniority.
> **Agents & LLMs**: a Markdown version of this page is available by appending `.md` to the URL, and the full documentation index is at [llms.txt](https://docs.blitz-api.ai/llms.txt).
**Cost:** 1 credit per employee returned on Trial Plan
**Free** on the Unlimited plan
Search all employees at a single company by job level, department, location, and seniority.
**Pagination is page-based.** Increment `page` until `page > total_pages` to walk the full result set. Pagination is limited to maximum of 10k results.
Browse all employees at a target company with filters — full walk-through with examples.
## OpenAPI
````yaml api-reference/v2.openapi.json POST /v2/search/employee-finder
openapi: 3.1.0
info:
title: Blitz API Reference
version: 2.0.0
description: >-
Welcome to the Blitz API Reference.
Use this interactive documentation to explore and test every v2 endpoint.
Authentication is required via the `x-api-key` header.
**Base URL**: `https://api.blitz-api.ai`
**Rate limit**: 5 requests per second, per endpoint (all plans). Each
endpoint has its own independent budget, so different endpoints don't share
the limit.
**Pricing**: All endpoints are unlimited on paid plans ($399+/mo). Free
trial accounts receive 1,000 credits.
servers:
- url: https://api.blitz-api.ai
description: Production server
security: []
tags:
- name: Account
description: API key info and health check.
- name: Waterfall ICP Search
description: Priority-based cascade search — find the best-match contact at a company.
- name: Employee Finder
description: Browse all employees at a single company with filters.
- name: Company Search
description: Search companies by industry, size, location, and keywords.
- name: People Enrichment
description: Enrich contacts with verified emails, phones, and reverse lookups.
- name: Company Enrichment
description: Enrich companies and resolve domain ↔ LinkedIn URL.
- name: Utilities
description: Helper endpoints (current date/time).
paths:
/v2/search/employee-finder:
post:
tags:
- People Search
summary: Employee Finder
description: >-
Search all employees at a single company by job level, department,
location, and seniority.
requestBody:
content:
application/json:
schema:
type: object
properties:
company_linkedin_url:
type: string
example: https://www.linkedin.com/company/openai
country_code:
type: array
items:
type: string
example:
- US
- FR
continent:
type: array
items:
type: string
example:
- Africa
- Antarctica
- Asia
- Europe
- North America
- Oceania
- South America
sales_region:
type: array
items:
type: string
example:
- NORAM
- LATAM
- EMEA
- APAC
job_level:
type: array
items:
type: string
example:
- C-Team
- Director
- Manager
- Other
- Staff
- VP
job_function:
type: array
items:
type: string
example:
- Advertising & Marketing
- Art, Culture and Creative Professionals
- Construction
- Customer/Client Service
- Education
- Engineering
- Finance & Accounting
- General Business & Management
- Healthcare & Human Services
- Human Resources
- Information Technology
- Legal
- Manufacturing & Production
- Operations
- Other
- Public Administration & Safety
- Purchasing
- Research & Development
- Sales & Business Development
- Science
- Supply Chain & Logistics
- Writing/Editing
min_connections_count:
type: number
example: 200
minimum: 0
maximum: 500
max_results:
type: number
example: 3
minimum: 1
maximum: 50
page:
type: number
example: 1
required:
- company_linkedin_url
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
example:
company_linkedin_url: https://www.linkedin.com/company/openai
max_results: 3
results_length: 3
page: 1
total_pages: 1285
results:
- first_name: Eric
last_name: Mitchell
full_name: Eric Mitchell
nickname: null
civility_title: null
headline: null
about_me: >-
I co-lead (with Yann Dubois) the Post-training Frontiers
team within Post-training at…
location:
city: null
state_code: null
country_code: US
continent: North America
linkedin_url: https://www.linkedin.com/in/ericanthonymitchell
connections_count: 200
profile_picture_url: >-
https://media.licdn.com/dms/image/v2/C5603AQF16tMUIXcPiA/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1517601421714
experiences:
- job_title: null
company_linkedin_url: https://www.linkedin.com/company/openai
company_linkedin_id: c51425c5-1b38-578d-a700-c5ca850261ae
company_domain: openai.com
job_description: null
job_start_date: null
job_end_date: null
job_is_current: true
job_location:
city: null
state_code: null
country_code: null
education: []
skills:
- java
- agile methodologies
- objective-c
- json
- mobile applications
- english
- software development
- python
- customer service
- c
- ios development
- scikit-learn
- xcode
certifications: []
- first_name: Alex
last_name: Barron
full_name: Alex Barron
nickname: null
civility_title: null
headline: ML
about_me: null
location:
city: San Francisco
state_code: CA
country_code: US
continent: North America
linkedin_url: https://www.linkedin.com/in/alexbarron1
connections_count: 200
profile_picture_url: >-
https://media.licdn.com/dms/image/v2/C5603AQHFO6JpxyUwBQ/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1517005697979
experiences:
- job_title: Member of Technical Staff
company_linkedin_url: https://www.linkedin.com/company/openai
company_linkedin_id: c51425c5-1b38-578d-a700-c5ca850261ae
company_domain: openai.com
job_description: null
job_start_date: '2025-04-01'
job_end_date: null
job_is_current: true
job_location:
city: San Francisco
state_code: CA
country_code: US
education:
- degree: Bachelor of Science (BS)
start_date: '2013-01-01'
end_date: '2017-01-01'
- degree: Master of Science (MS)
start_date: '2016-01-01'
end_date: '2017-01-01'
skills:
- microsoft office
- python
- c++
- objective-c
- c
- javascript
- swift
- java
certifications: []
- first_name: Shane
last_name: Copenhagen
full_name: Shane Copenhagen
nickname: null
civility_title: null
headline: Robotics Software Engineer
about_me: >-
A Robotics Software Engineer with a BS in CS+Robotics
from Colorado School of Mines. My…
location:
city: Golden
state_code: CO
country_code: US
continent: North America
linkedin_url: https://www.linkedin.com/in/shane-copenhagen
connections_count: 200
profile_picture_url: >-
https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2
experiences:
- job_title: Independent Contractor
company_linkedin_url: https://www.linkedin.com/company/openai
company_linkedin_id: c51425c5-1b38-578d-a700-c5ca850261ae
company_domain: openai.com
job_description: >-
Building AI-enabled tools and bots for the OpenAI
Community.
job_start_date: '2023-02-01'
job_end_date: null
job_is_current: true
job_location:
city: null
state_code: null
country_code: null
education: []
skills:
- javascript
- computers
- public speaking
- banking
- html5
- database design
- insurance
- life insurance
- spanish-english
- java
- css3
certifications: []
'402':
description: Payment Required
content:
application/json:
schema:
type: object
example:
message: Insufficient credits balance
'422':
description: Unprocessable Entity
content:
application/json:
schema:
type: object
example:
success: false
error:
code: INVALID_INPUT
message: Missing required fields
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
example:
success: false
message: >-
this is a controlled error. created at
2025-07-11T10:20:00.000Z
security:
- APIKey: []
components:
securitySchemes:
APIKey:
type: apiKey
in: header
name: x-api-key
description: Your Blitz API Key. Get one from https://app.blitz-api.ai
````