Find prospects
find_prospectsRead-onlyIdempotent
Requires a Pro plan. Prospect lists: companies at any include edition and at none of the exclude editions ("at A or B, not at C"), most editions attended first, then most recent (20 per page). A side is an event (slug or uuid, optional years; default its latest 5 past editions) or an edition_id; at most 5 editions per side; oversized editions are refused as too_broad. Optional HQ country and role. Returns company, hits, last edition and url, total_about, and editions_used with each edition's as_of.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | "exhibitor" ignores sponsor lists. Defaults to both. | any |
| cursor | No | Opaque cursor from the previous page's `next_cursor` (only valid with the same arguments). | |
| country | No | ISO-3166 alpha-2 (TH, DE, JP …). | |
| exclude | No | Editions to rule out: companies at any of these are dropped. | |
| include | Yes | Editions the companies attended (any of them). |