Waterfall ICP Search

curl --request POST \
  --url https://api.blitz-api.ai/v2/search/waterfall-icp-keyword \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "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
    }
  ]
}
'

import requests

url = "https://api.blitz-api.ai/v2/search/waterfall-icp-keyword"

payload = {
    "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
        }
    ]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
      }
    ]
  })
};

fetch('https://api.blitz-api.ai/v2/search/waterfall-icp-keyword', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blitz-api.ai/v2/search/waterfall-icp-keyword",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.blitz-api.ai/v2/search/waterfall-icp-keyword"

	payload := strings.NewReader("{\n  \"company_linkedin_url\": \"https://www.linkedin.com/company/openai\",\n  \"cascade\": [\n    {\n      \"include_title\": [\n        \"Marketing Director\",\n        \"Head Marketing\",\n        \"Chief Marketing Officer\"\n      ],\n      \"exclude_title\": [\n        \"assistant\",\n        \"intern\",\n        \"product\",\n        \"junior\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Marketing Manager\",\n        \"Head Growth\",\n        \"Growth manager\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"hacker\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication Director\",\n        \"Brand Director\",\n        \"Content Director\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"UX\",\n        \"UI\",\n        \"Design\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication Manager\",\n        \"Brand Manager\",\n        \"Content Manager\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication\",\n        \"marketing\",\n        \"growth\",\n        \"brand\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"product\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": true\n    },\n    {\n      \"include_title\": [\n        \"CEO\",\n        \"founder\",\n        \"cofounder\",\n        \"owner\",\n        \"General Director\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.blitz-api.ai/v2/search/waterfall-icp-keyword")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"company_linkedin_url\": \"https://www.linkedin.com/company/openai\",\n  \"cascade\": [\n    {\n      \"include_title\": [\n        \"Marketing Director\",\n        \"Head Marketing\",\n        \"Chief Marketing Officer\"\n      ],\n      \"exclude_title\": [\n        \"assistant\",\n        \"intern\",\n        \"product\",\n        \"junior\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Marketing Manager\",\n        \"Head Growth\",\n        \"Growth manager\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"hacker\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication Director\",\n        \"Brand Director\",\n        \"Content Director\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"UX\",\n        \"UI\",\n        \"Design\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication Manager\",\n        \"Brand Manager\",\n        \"Content Manager\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication\",\n        \"marketing\",\n        \"growth\",\n        \"brand\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"product\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": true\n    },\n    {\n      \"include_title\": [\n        \"CEO\",\n        \"founder\",\n        \"cofounder\",\n        \"owner\",\n        \"General Director\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.blitz-api.ai/v2/search/waterfall-icp-keyword")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"company_linkedin_url\": \"https://www.linkedin.com/company/openai\",\n  \"cascade\": [\n    {\n      \"include_title\": [\n        \"Marketing Director\",\n        \"Head Marketing\",\n        \"Chief Marketing Officer\"\n      ],\n      \"exclude_title\": [\n        \"assistant\",\n        \"intern\",\n        \"product\",\n        \"junior\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Marketing Manager\",\n        \"Head Growth\",\n        \"Growth manager\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"hacker\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication Director\",\n        \"Brand Director\",\n        \"Content Director\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"UX\",\n        \"UI\",\n        \"Design\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication Manager\",\n        \"Brand Manager\",\n        \"Content Manager\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    },\n    {\n      \"include_title\": [\n        \"Communication\",\n        \"marketing\",\n        \"growth\",\n        \"brand\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\",\n        \"product\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": true\n    },\n    {\n      \"include_title\": [\n        \"CEO\",\n        \"founder\",\n        \"cofounder\",\n        \"owner\",\n        \"General Director\"\n      ],\n      \"exclude_title\": [\n        \"junior\",\n        \"assistant\",\n        \"intern\"\n      ],\n      \"location\": [\n        \"WORLD\"\n      ],\n      \"include_headline_search\": false\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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": []
      }
    }
  ]
}

{
  "message": "Insufficient credits balance"
}

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Missing required fields"
  }
}

{
  "success": false,
  "message": "this is a controlled error. created at 2025-07-11T10:20:00.000Z"
}