Helpers
List Firmographic Options
Returns the firmographic filter values accepted by the lookalike search endpoints One-shot discovery call - static, safe to cache.
GET
List firmographic options
Headers
Response
200 - application/json
Successful Response
Acceptable firmographic filter values for the lookalike search endpoints (GET /search-lookalikes and POST /search-lookalikes-bulk).
Bounds for the min_employees filter.
Bounds for the max_employees filter.
Exact funding-stage labels accepted by funding_stages. Input is matched case-insensitively and canonicalized to these values.
Supported HQ-country filters. Pass the code in the locations parameter.
Previous
Search Lookalikes Bulk ResultsPoll a bulk lookalike job and page through its results. Submit a job first via **`POST /api/v1/account/search-lookalikes-bulk`** ("Search Lookalikes Bulk", under Company Search), which returns a `job_id`.
<Info>**No API key yet?** [Sign up via Agent Auth](/agent-primitives/authentication) to get your `X-API-Key` - the only required header for this endpoint.</Info>
This single endpoint returns both the job `status` (`pending` → `running` → `completed` / `failed`), a `manifest` summary once complete, **and** one page of result `rows`. Walk pages by passing the returned `next_cursor` as `?cursor=`.
**Check `status` for completion - not `next_cursor`.** A still-running job can return a null `next_cursor` simply because later pages haven't been written yet; only `status: "completed"` means the full result set is available.
No credits are charged for polling - the job's credits are billed once, when it completes.
Next
List firmographic options