Search People
Searches, filters, or browses people and returns a page of people matching the filters in the request body. semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence. Without semanticQuery or search, a default-sorted page emits an X-Next-Cursor keyset continuation; send it back as cursor, without sort, to read the next page.
Authentication
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Query parameters
Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.
Opaque continuation from X-Next-Cursor. Repeat the same filters and size; a semantic cursor also repeats sort, a keyset cursor omits it.
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
Request
Require a second, independent association of the same person, AND-ed with the primary association constraints, e.g. a past employer.
Constraints on the associated entity, as on POST /v1/search/natural/entities: a person matches when an association (current by default; selectable with tenure) points at an entity matching every field and visible in entity listings, such as yearFoundedRange, hasFundraising, or fundraiseActivity.totalRaisedRange. Omit for no associated-entity constraint.
Legacy tenure filter; omit when selecting tenure explicitly.
First-name initial.
Name eligibility independent of search; preserve it on replay.
Specific person IDs; omit or use [] for no restriction.
Rank people who run the most prominent matching employers first, ahead of sort (founders and management, then other operators, then board seats). Applies only when entityId, entitySlug, arrayFilter.entityName, or the entityId, slug, entityName, or fundraiseActivity.investorEntityId or investorName of entityFilter or additionalAssociation.entityFilter names the employers.
Search keyword or phrase. Single characters valid; stop words rejected.
Semantic person search phrase. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching person.
Tenure of the association title and employer match: CURRENT, PAST, or ANY. Omitted, titles match any tenure and employers current; isCurrent must agree.
Response headers
Opaque continuation token, present when another page exists; send it as cursor to read that page. The body’s number, first, and totalPages describe offset paging only; they do not advance while you follow cursors. With semanticQuery it continues the semantic window from page 0; otherwise it is a keyset over the default sort.
Requests allowed per client IP in the current rate-limit window.
Requests left before the tightest applicable rate-limit bucket rejects.
Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.