aVenture APIEntities

Search companies, products, and services

View as Markdown
Run keyword, semantic, or explicit structured entity filtering with an EntityListFilter JSON body; Organization expands to the canonical organization type group; semanticQuery ranks by stored content embeddings. For plain English use search natural entities `--query` (POST /v1/search/natural/entities). Semantic results can emit signed cursors; reuse the same filters, sort, size, and visibility scope. countOnly is unsupported with semanticQuery or cursor; count-only pages have no content; read totalElements.

Authentication

AuthorizationBearer

User bearer token: Clerk session JWT, Clerk OAuth access token, or Clerk API key

Query parameters

countOnlybooleanOptional
Return only the matching entity count in totalElements. Content is empty by design, so the page empty flag describes content, not whether matches exist. Unsupported with semanticQuery.
permitMonogrambooleanOptional
Allow generated monogram logos in results.
includePrivatebooleanOptional

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

cursorstringOptional

Opaque entity cursor; reuse filters and sort. Cursor is unsupported with countOnly; semanticQuery depends on the endpoint.

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 25
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.

includeFullDetailbooleanOptional

Privileged read flag. Must be true to return the /v1/entities/detail payload.

Request

This endpoint expects an object.
acceleratorBrandlist of stringsOptional
Accelerator brand or operator name.
acceleratorCohortlist of stringsOptional
Accelerator batch or cohort label.
acceleratorNamelist of stringsOptional
Specific accelerator program name.
acceleratorStatuslist of stringsOptional
Accelerator participation status.
affinitylist of stringsOptional

Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.

employeeCountRangelist of objectsOptional

Inclusive reported employee-count ranges, in employees.

entityIdlist of stringsOptional
Restrict results to specific entity IDs.
entityNamelist of stringsOptional
Exact normalized match against entity brand or legal names.
featuredboolean or nullOptional
Filter by featured status.
fundraiseActivityobjectOptional
Fundraise activity
hasFundraisingboolean or nullOptional
Filter to entities with fundraise activity.
headquartersCitylist of stringsOptional
Headquarters city values.
headquartersCountrylist of stringsOptional
Headquarters country values.
headquartersStatelist of stringsOptional
Headquarters state or region values.
industrylist of stringsOptional
Industry classification values.
letterstring or nullOptional
First letter of the display name.
locationlist of stringsOptional
Geographic classification values.
logoOptionobjectOptional
Logo sort priority.
mainProductlist of stringsOptional
Main product classification values.
operatingStatuslist of enumsOptional

Operating states to include; omit to include every state.

personlist of stringsOptional
Associated person, matched by name.
portfolioHeadquartersCitylist of stringsOptional

Portfolio-company headquarters city values.

portfolioHeadquartersCountrylist of stringsOptional

Portfolio-company headquarters country values.

portfolioHeadquartersStatelist of stringsOptional

Portfolio-company headquarters state or region values.

qualityGateenumOptional

Named server-owned list quality gate.

Allowed values:
semanticQuerystring or nullOptional

Semantic entity search phrase. Executable on POST /v1/entities/search; saved views persist it for replay.

sluglist of stringsOptional
Restrict results to entity slugs.
stagelist of stringsOptional
Investment stage classification values.
suppressNonOperatingboolean or nullOptional
Suppress entities with terminal operating status.
suppressZeroTotalRaisedboolean or nullOptional
Suppress entities whose total raised is zero.
taglist of stringsOptional
General classification tag values.
textSearchstring or nullOptional

Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.

typeCustomerlist of stringsOptional

Customer-type classification values.

typeModellist of stringsOptional

Business-model classification values.

typeOwnershiplist of stringsOptional

Ownership-model classification values.

typeRecordlist of enumsOptional

Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type.

typeRevenuelist of stringsOptional

Revenue-model classification values.

typeTechnologyUsedlist of stringsOptional

Technology-used classification values.

urlstring or nullOptional
Current URL to match by normalized host and path.
urlDomainstring or nullOptional

Current root domain to match when urlMatchMode=domain.

urlMatchModeenumOptional

URL matching mode: hostPath uses host and path; domain uses the root domain.

Allowed values:
urlTypeenum or nullOptional
Restrict URL matching to one URL type.
yearFoundedRangelist of objectsOptional

Inclusive founding-year ranges, in calendar years.

Response headers

X-Next-CursorstringOptional

Opaque sort-aware continuation token when another page is available

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

OK
PageEntityListobject
OR
PageEntityDetailobject

Errors

400
Bad Request Error
401
Unauthorized 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