Waterfall ICP Search

Find decision-makers at a company using an ordered role and location cascade.

POST/v2/search/waterfall-icp-keyword

Request

curl -X POST "https://moltsetz.vercel.app/v2/search/waterfall-icp-keyword" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "company_linkedin_url": "https://www.linkedin.com/company/openai",
  "cascade": [
    {
      "include_title": [
        "VP Marketing",
        "Head of Growth"
      ],
      "exclude_title": [
        "Assistant"
      ],
      "location": [
        "WORLD"
      ]
    }
  ],
  "max_results": 10
}'

Body

Field	Type	Required	Description and limits
`company_linkedin_url`	string	Required	Canonical or trailing-slash LinkedIn company profile URL.linkedin.com/company/{slug}
`cascade`	object[]	Required	Ordered ICP steps with include_title, exclude_title, and location string arrays.1–10 steps; each step needs non-empty include_title or location
`max_results`	integer	Optional	Maximum records returned.1–100; defaults to 10

Pagination

This endpoint is not paginated.

Credits

One request credit is recorded only when this endpoint returns a 2xx response. Authentication, validation, rate-limit, and not-found responses do not consume a credit.

Response

Field	Type	Description
`company_linkedin_url`	string	Normalized company URL.
`max_results`	integer	Applied result limit.
`results`	array	The records returned for this page.
`results_length`	integer	Number of records in results.

Example response

{
  "company_linkedin_url": "https://www.linkedin.com/company/openai",
  "max_results": 10,
  "results_length": 1,
  "results": [
    {
      "icp": 1,
      "ranking": 1,
      "person": {
        "full_name": "Example Person",
        "job_title": "VP Marketing"
      }
    }
  ]
}

Errors

Status	Code	When
`422`	`INVALID_INPUT`	A required value is missing, malformed, or outside its documented limits.
`401`	`UNAUTHORIZED`	The x-api-key header is missing or invalid.
`402`	`CREDITS_EXHAUSTED`	A limited plan has no request credits remaining.
`405`	`METHOD_NOT_ALLOWED`	The endpoint is called with an unsupported HTTP method.
`429`	`RATE_LIMIT_EXCEEDED`	The API key exceeds its plan-wide requests-per-second limit.
`500`	`DATA_SERVICE_ERROR`	The data service cannot complete the request.

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "A field-specific validation message"
  }
}

All endpoints Create an API key