> ## 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.
# Waterfall ICP Search
> Find the best decision-maker at a target company using a prioritized cascade hierarchy.
> **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 person returned on Trial Plan
**Free** on the Unlimited plan
Find the best decision-maker at a target company using a prioritized cascade hierarchy. The engine tries each tier in order and stops as soon as `max_results` is reached.
**Job title - exact match:** wrap a value in square brackets to switch from keyword matching to exact matching. `"[CEO]"` matches only `CEO`/`ceo`/`Céo`; `"CEO"` (no brackets) is FTS (full text search) and also matches `Co-CEO`, `CEO Office`. Mixed arrays are allowed: `["[CEO]", "Founder"]`. [Full rules](/guide/reference/normalization/filters).
**`icp`** is the cascade tier that matched (1 = highest priority).
**`ranking`** is overall relevance within the company (1 = most relevant).
Two different signals that you can combine when ordering results client-side.
How the cascade picks the right contact when you don't have a profile URL.
## OpenAPI
````yaml api-reference/v2.openapi.json POST /v2/search/waterfall-icp-keyword
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/waterfall-icp-keyword:
post:
tags:
- People Search
summary: Waterfall ICP Search
description: >-
Find the best decision-maker at a target company using a prioritized
cascade hierarchy.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- company_linkedin_url
- cascade
properties:
company_linkedin_url:
type: string
format: uri
example: https://www.linkedin.com/company/openai
cascade:
type: array
description: >-
Ordered list of search tiers. Each tier is attempted in
sequence; the next is used only if the previous yields no
results.
minItems: 1
items:
type: object
required:
- include_title
- location
- include_headline_search
properties:
include_title:
type: array
items:
type: string
description: Job title keywords that contacts must match.
example:
- Marketing Director
- Head Marketing
- Chief Marketing Officer
exclude_title:
type: array
items:
type: string
description: Job title keywords that disqualify a contact.
example:
- assistant
- intern
- junior
location:
type: array
items:
type: string
description: Geographic filter. Use 'WORLD' for no restriction.
example:
- WORLD
include_headline_search:
type: boolean
description: >-
When true, also searches LinkedIn headline text in
addition to job title.
example: false
max_results:
type: number
description: Maximum number of results to return.
example: 10
minimum: 1
maximum: 100
example:
company_linkedin_url: https://www.linkedin.com/company/openai
cascade:
- include_title:
- Marketing Director
- Head Marketing
- Chief Marketing Officer
exclude_title:
- assistant
- intern
- product
- junior
location:
- WORLD
include_headline_search: false
- include_title:
- Marketing Manager
- Head Growth
- Growth manager
exclude_title:
- junior
- assistant
- intern
- hacker
location:
- WORLD
include_headline_search: false
- include_title:
- Communication Director
- Brand Director
- Content Director
exclude_title:
- junior
- assistant
- intern
- UX
- UI
- Design
location:
- WORLD
include_headline_search: false
- include_title:
- Communication Manager
- Brand Manager
- Content Manager
exclude_title:
- junior
- assistant
- intern
location:
- WORLD
include_headline_search: false
- include_title:
- Communication
- marketing
- growth
- brand
exclude_title:
- junior
- assistant
- intern
- product
location:
- WORLD
include_headline_search: true
- include_title:
- CEO
- founder
- cofounder
- owner
- General Director
exclude_title:
- junior
- assistant
- intern
location:
- WORLD
include_headline_search: false
max_results: 10
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
company_linkedin_url:
type: string
max_results:
type: number
results_length:
type: number
results:
type: array
items:
type: object
properties:
icp:
type: number
description: >-
Index (1-based) of the cascade tier that matched
this result.
ranking:
type: number
description: Overall rank of this result across all tiers.
person:
type: object
properties:
first_name:
type: string
last_name:
type: string
full_name:
type: string
nickname:
type:
- string
- 'null'
civility_title:
type:
- string
- 'null'
headline:
type:
- string
- 'null'
about_me:
type:
- string
- 'null'
location:
type: object
properties:
city:
type:
- string
- 'null'
state_code:
type:
- string
- 'null'
country_code:
type:
- string
- 'null'
continent:
type:
- string
- 'null'
linkedin_url:
type: string
connections_count:
type: number
profile_picture_url:
type:
- string
- 'null'
experiences:
type: array
items:
type: object
properties:
job_title:
type: string
company_linkedin_url:
type: string
company_linkedin_id:
type: string
company_domain:
type: string
job_description:
type:
- string
- 'null'
job_start_date:
type:
- string
- 'null'
format: date
job_end_date:
type:
- string
- 'null'
format: date
job_is_current:
type: boolean
job_location:
type: object
properties:
city:
type:
- string
- 'null'
state_code:
type:
- string
- 'null'
country_code:
type:
- string
- 'null'
education:
type: array
items:
type: object
properties:
degree:
type: string
start_date:
type:
- string
- 'null'
format: date
end_date:
type:
- string
- 'null'
format: date
skills:
type: array
items:
type: string
certifications:
type: array
items:
type: object
properties:
authority:
type: string
name:
type: string
url:
type:
- string
- 'null'
example:
company_linkedin_url: https://www.linkedin.com/company/openai
max_results: 3
results_length: 3
results:
- icp: 2
ranking: 1
person:
first_name: Gio
last_name: Santiago
full_name: Gio Santiago
nickname: null
civility_title: null
headline: >-
Events @ OpenAI | Experiential Marketing | Ex-Condé Nast
| Digital Content Strategist | Fulbright Alumni
about_me: >-
Passionate, hands on, and innovation-centered events and
digital media creative with 8+…
location:
city: New York
state_code: NY
country_code: US
continent: North America
linkedin_url: https://www.linkedin.com/in/gio-santiago
connections_count: 500
profile_picture_url: >-
https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2
experiences:
- job_title: >-
Comms Events, Associate Events Manager, Gtm B2b
Marketing
company_linkedin_url: https://www.linkedin.com/company/openai
company_linkedin_id: c51425c5-1b38-578d-a700-c5ca850261ae
company_domain: openai.com
job_description: >-
I am currently working as an associate event manager
at OpenAI on the comms events team, producing
marketing and GTM tentpoles across the US, EMEA, and
APAC.
job_start_date: '2025-05-01'
job_end_date: null
job_is_current: true
job_location:
city: New York
state_code: NY
country_code: US
education: []
skills:
- research
- ecology
- editing
- environmental science
- environmental education
- environmental awareness
- public speaking
- organizational leadership
- nonprofits
- community outreach
- management
- volunteer management
certifications:
- authority: Acumen, LLC
name: Adaptive Leadership Certification
- authority: PADI
name: PADI Advanced Open Water Scuba Diver
- icp: 2
ranking: 2
person:
first_name: Alison
last_name: Harmon
full_name: Alison Harmon
nickname: null
civility_title: null
headline: null
about_me: null
location:
city: San Francisco
state_code: CA
country_code: US
continent: North America
linkedin_url: https://www.linkedin.com/in/alisonharmon
connections_count: 500
profile_picture_url: >-
https://media.licdn.com/dms/image/v2/C5603AQHDyMfUDPEWvQ/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1630362000214
experiences:
- job_title: Head of Growth
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: '2023-09-01'
job_end_date: null
job_is_current: true
job_location:
city: null
state_code: null
country_code: null
education: []
skills:
- matlab
- crystal healing
- apis
- goats
- mathematica
- r
- microsoft word
- microsoft office
- weapons handling
- statistics
- calculus
- mathematical modeling
- astrophysics
- desk
- mathematical analysis
- science
- astrology
- asana
- linear algebra
- lead generation
- mathematics
- physics
- python
certifications: []
- icp: 2
ranking: 3
person:
first_name: Pearl
last_name: Aguilar
full_name: Pearl Aguilar
nickname: null
civility_title: null
headline: Senior Digital Marketing Manager at OpenAI
about_me: >-
With a proven track record in the digital marketing
landscape, I specialize in driving…
location:
city: null
state_code: null
country_code: GB
continent: Europe
linkedin_url: https://www.linkedin.com/in/pearl-aguilar-76b9b5208
connections_count: 500
profile_picture_url: >-
https://media.licdn.com/dms/image/v2/C5603AQGbgR8KVYAKrw/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1643629859057
experiences:
- job_title: Digital Marketing Manager
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: '2024-06-01'
job_end_date: null
job_is_current: true
job_location:
city: London
state_code: null
country_code: GB
education:
- degree: Bachelor of Engineering - BE
skills: []
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
````