Skip to main content

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 — POST /v2/search/waterfall-icp-keyword

Find the best decision-maker at a company using a prioritized cascade. The engine tries each tier in order and fills results from the highest-priority match first.
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.
icp = cascade tier matched (1 = top priority). ranking = overall position in the company (1 = most relevant).
This snippet uses the blitzRequest / blitz_request client defined in the Code Examples hub. Copy that first.
const result = await blitzRequest("POST", "/v2/search/waterfall-icp-keyword", {
  company_linkedin_url: "https://www.linkedin.com/company/openai",
  cascade: [
    {
      include_title: ["CTO", "VP Engineering", "Head of Engineering"],
      exclude_title: ["assistant", "intern", "junior"],
      location: ["WORLD"],
      include_headline_search: false,
    },
    {
      include_title: ["Engineering Director", "Engineering Manager"],
      exclude_title: ["junior", "intern"],
      location: ["WORLD"],
      include_headline_search: false,
    },
    {
      include_title: ["CEO", "Founder", "CTO"],
      exclude_title: ["intern"],
      location: ["WORLD"],
      include_headline_search: false,
    },
  ],
  max_results: 5,
});

for (const person of result.results) {
  const p = person.person;
  console.log(`[Tier ${person.icp} | Rank #${person.ranking}] ${p.full_name} — ${p.headline}`);
  console.log(`  LinkedIn: ${p.linkedin_url}`);
  // icp: which cascade tier matched (1 = top priority)
  // ranking: overall position in company (1 = most relevant)
}