Skip to main content
POST
/
v2
/
search
/
waterfall-icp-keyword
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
    }
  ]
}
'
{
  "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",
            "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",
            "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",
            "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": []
      }
    }
  ]
}

Authorizations

x-api-key
string
header
required

Your Blitz API Key. Get one from https://app.blitz-api.ai

Body

application/json
company_linkedin_url
string<uri>
required
Example:

"https://www.linkedin.com/company/openai"

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.

Minimum array length: 1
max_results
number

Maximum number of results to return.

Example:

10

Response

OK

company_linkedin_url
string
max_results
number
results_length
number
results
object[]