aVenture APINatural Search

Find companies, startups, and investors in natural language

View as Markdown
Translate a plain-English company, startup, investor, investment firm, or investment manager search into the canonical EntityFilter contract, execute the existing entity list engine, and return both the interpretation and ranked entity list page. Unsupported constraints are named in the interpretation instead of being silently ignored. Explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset. Example: search.query 'AI infrastructure companies founded since 2020' with size=3. The query accepts plain English; size limits the page, page starts at 0, and filter.yearFoundedRange [{"min":2020}] imposes a hard founding-year constraint. Set includePrivate=false for publicly visible results.

Authentication

AuthorizationBearer

User bearer token: an aVenture API key, an OAuth access token, or a signed-in session token

Query parameters

permitMonogrambooleanOptional
When false, generated monogram logos are stripped from entity rows.
includePrivatebooleanOptional

Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller’s default visibility.

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 40
The size of the page to be returned
sortlist of stringsOptional

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Request

This endpoint expects an object.
searchobjectRequired

Canonical plain-English search request and strategy.

filterobjectOptional

Explicit entity constraints. Caller-supplied fields override planner values; the planner fills only fields left at their canonical defaults.

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

Ranked entity matches for the interpreted query.
interpretationobject
Structured interpretation used to run the entity list query.
resultobject
Entity list page returned by the canonical entity list engine.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error