---
title: "Waterfall ICP Search"
method: POST
path: "/v2/search/waterfall-icp-keyword"
tags: ["People Search"]
---

# Waterfall ICP Search

`POST /v2/search/waterfall-icp-keyword`

Find the best decision-maker at a target company using a prioritized cascade hierarchy.

## Request body

- object
  - `company_linkedin_url` string, uri, required
  - `cascade` object[], required — Ordered list of search tiers. Each tier is attempted in sequence; the next is used only if the previous yields no results.
    - `include_title` string[], required — Job title keywords that contacts must match.
    - `exclude_title` string[] — Job title keywords that disqualify a contact.
    - `location` string[], required — Geographic filter. Use 'WORLD' for no restriction.
    - `include_headline_search` boolean, required — When true, also searches LinkedIn headline text in addition to job title.
  - `max_results` number — Maximum number of results to return.

## Response `200`

OK

- object
  - `company_linkedin_url` string
  - `max_results` number
  - `results_length` number
  - `results` object[]
    - `icp` number — Index (1-based) of the cascade tier that matched this result.
    - `ranking` number — Overall rank of this result across all tiers.
    - `person` object
      - `first_name` string
      - `last_name` string
      - `full_name` string
      - `nickname` string, nullable
      - `civility_title` string, nullable
      - `headline` string, nullable
      - `about_me` string, nullable
      - `location` object
        - `city` string, nullable
        - `state_code` string, nullable
        - `country_code` string, nullable
        - `continent` string, nullable
      - `linkedin_url` string
      - `connections_count` number
      - `profile_picture_url` string, nullable
      - `experiences` object[]
        - `job_title` string
        - `company_linkedin_url` string
        - `company_linkedin_id` string
        - `company_domain` string
        - `job_description` string, nullable
        - `job_start_date` string, date, nullable
        - `job_end_date` string, date, nullable
        - `job_is_current` boolean
        - `job_location` object
          - `city` string, nullable
          - `state_code` string, nullable
          - `country_code` string, nullable
      - `education` object[]
        - `degree` string
        - `start_date` string, date, nullable
        - `end_date` string, date, nullable
      - `skills` string[]
      - `certifications` object[]
        - `authority` string
        - `name` string
        - `url` string, nullable

## Other responses

- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/blitz-api/apis/blitz-api-reference.md) · [All operations](https://skmtc.dev/blitz-api/apis/blitz-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blitz-api/blitz-api-reference/revisions/ef6509a474f8/schema)