> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.aventure.vc/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aventure.vc/_mcp/server. # Search entities, people, and news POST https://api.aventure.vc/v1/search/all Content-Type: application/json Runs the canonical entity, person, and news search engines sequentially and returns their typed result pages with per-scope strategy provenance. Supports only auto and keyword modes; unsupported modes are rejected before any scope runs. Page and size apply to every scope; cross-domain sort is not supported. Reference: https://docs.aventure.vc/api-reference/a-venture-api/search/all ## Authentication - `Authorization` header (bearer token, required) — User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key - `X-API-Key` header (required) — Admin API key for system-to-system write operations - `X-Client-Secret` header (required) — Client secret for read-only service-to-service access (no writes) ## Request ### Query parameters - `page` (integer, optional, default: 0) — Zero-based page index (0..N) - `size` (integer, optional, default: 20) — The size of the page to be returned - `sort` (list of string, optional) — Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported. ### Body (application/json) - `query` (string, required) — Plain-English search request. - `mode` (enum, optional) — Search strategy to run. Accepted values narrow per surface: entity and person natural-search take every value (`exact` is entity-only); news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Defaults to `auto`, which keeps the server-chosen pipeline; any other value forces exactly that strategy. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `model` (string, optional, nullable) — Optional chat model for planning; null uses the configured natural-search default. CLIENT_SECRET callers may only choose client-secret-eligible models; admin keys are unrestricted. ## Response ### 200 OK - `entity` (object, required) — Canonical entity natural-search result. - `interpretation` (object, required) — Structured interpretation used to run the entity list query. - `confidence` (enum, required) — Planner confidence in the structured interpretation. - Allowed values: `HIGH`, `MEDIUM`, `LOW` - `execution` (object, required) — Requested and executed search strategy. - `modeRequested` (enum, required) — Search mode requested by the caller. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `modeUsed` (enum, required) — Search mode executed by the canonical engine. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `fallbackUsed` (boolean, required) — True when the semantic fallback replaced an untranslatable planner result with a semantic search over the original query. - `filter` (object, required) — Canonical entity filter generated from the natural-language query. - `acceleratorBrand` (list of string, optional) — Accelerator brand or operator name. - `acceleratorCohort` (list of string, optional) — Accelerator batch or cohort label. - `acceleratorName` (list of string, optional) — Specific accelerator program name. - `acceleratorStatus` (list of string, optional) — Accelerator participation status. - `affinity` (list of string, optional) — Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names. - `employeeCountRange` (list of object, optional) — Inclusive reported employee-count ranges, in employees. - `max` (integer, optional, nullable) — Inclusive maximum integer. - `min` (integer, optional, nullable) — Inclusive minimum integer. - `entityId` (list of string, optional) — Restrict results to specific entity IDs. - `entityName` (list of string, optional) — Exact normalized match against entity brand or legal names. - `featured` (boolean, optional, nullable) — Filter by featured status. - `fundraiseActivity` (object, optional) — Fundraise activity - `amountInvestedRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `amountRaisedRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `investedCompanyName` (list of string, optional) — Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies. - `investorActivity` (object, optional) — Aggregate investor activity filters. - `averageAmountInvestedUsdRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `largestAmountInvestedUsdRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `smallestAmountInvestedUsdRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `totalAmountInvestedUsdRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `totalInvestmentRange` (list of object, optional) - `max` (integer, optional, nullable) — Inclusive maximum integer. - `min` (integer, optional, nullable) — Inclusive minimum integer. - `lastRoundYearRange` (list of object, optional) - `max` (integer, optional, nullable) — Inclusive maximum integer. - `min` (integer, optional, nullable) — Inclusive minimum integer. - `round` (list of string, optional) — Fundraise round labels, such as Seed or Series A. - `totalRaisedRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `valuationRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `hasFundraising` (boolean, optional, nullable) — Filter to entities with fundraise activity. - `headquartersCity` (list of string, optional) — Headquarters city values. - `headquartersCountry` (list of string, optional) — Headquarters country values. - `headquartersState` (list of string, optional) — Headquarters state or region values. - `industry` (list of string, optional) — Industry classification values. - `letter` (string, optional, nullable) — First letter of the display name. - `location` (list of string, optional) — Geographic classification values. - `logoOption` (object, optional) — Logo sort priority. - `sortPriority` (enum, required) — Logo sort priority. - Allowed values: `NONE`, `ANY_LOGO_FIRST`, `REAL_LOGO_FIRST` - `mainProduct` (list of string, optional) — Main product classification values. - `operatingStatus` (list of string, optional) — Operating status values. - `portfolioHeadquartersCity` (list of string, optional) — Portfolio-company headquarters city values. - `portfolioHeadquartersCountry` (list of string, optional) — Portfolio-company headquarters country values. - `portfolioHeadquartersState` (list of string, optional) — Portfolio-company headquarters state or region values. - `qualityGate` (enum, optional) — Named server-owned list quality gate. - Allowed values: `NONE`, `COMPANY_LISTING_READY` - `semanticQuery` (string, optional, nullable) — Semantic entity search phrase. - `slug` (list of string, optional) — Restrict results to entity slugs. - `stage` (list of string, optional) — Investment stage classification values. - `suppressNonOperating` (boolean, optional, nullable) — Suppress entities with terminal operating status. - `suppressZeroTotalRaised` (boolean, optional, nullable) — Suppress entities whose total raised is zero. - `tag` (list of string, optional) — General classification tag values. - `textSearch` (string, optional, nullable) — Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests. - `typeCustomer` (list of string, optional) — Customer-type classification values. - `typeModel` (list of string, optional) — Business-model classification values. - `typeOwnership` (list of string, optional) — Ownership-model classification values. - `typeRecord` (list of enum, optional) — Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. - Allowed values: `Company`, `Investment Firm`, `Fund`, `Nonprofit`, `Government`, `Organization`, `Business Line`, `Product`, `Service` - `typeRevenue` (list of string, optional) — Revenue-model classification values. - `typeTechnologyUsed` (list of string, optional) — Technology-used classification values. - `url` (string, optional, nullable) — Current URL to match by normalized host and path. - `urlDomain` (string, optional, nullable) — Current root domain to match when urlMatchMode=domain. - `urlMatchMode` (enum, optional) — URL matching mode: hostPath uses host and path; domain uses the root domain. - Allowed values: `hostPath`, `domain` - `urlType` (enum, optional, nullable) — Restrict URL matching to one URL type. - Allowed values: `website`, `linkedin`, `twitter`, `github`, `facebook`, `instagram`, `tiktok`, `youtube`, `subreddit`, `forum`, `documentation`, `support`, `statuspage`, `changelog`, `roadmap`, `discord`, `crunchbase`, `wellfound`, `angellist`, `glassdoor`, `theorg`, `ycombinator`, `wikipedia`, `pitchbook`, `morningstar`, `bloomberg`, `nyse`, `nasdaq`, `g2`, `producthunt`, `trustpilot`, `alternativeto`, `gartnerpeerinsights`, `getapp`, `sourceforge`, `appstore`, `googleplay`, `capterra`, `trustradius`, `hubspotmarketplace`, `slackappdirectory`, `awsmarketplace`, `salesforceappexchange`, `chromewebstore`, `vscodemarketplace`, `npm`, `pypi`, `maven`, `dockerhub`, `homebrew`, `crates` - `yearFoundedRange` (list of object, optional) — Inclusive founding-year ranges, in calendar years. - `max` (integer, optional, nullable) — Inclusive maximum integer. - `min` (integer, optional, nullable) — Inclusive minimum integer. - `interpretation` (string, required) — Human-readable summary of how the query was interpreted. - `sort` (object, required) — Sort applied to the result page. Empty when the page was ordered by semantic relevance rank instead of a sortable column. - `order` (list of object, required) — Ordered sort terms. Empty list means unspecified at the HTTP boundary (defaults apply). - `descending` (boolean, required) — true for descending (DESC), false for ascending (ASC) - `field` (enum, required) — Sort field for this resource (entity list uses EntityFilter.Sortable / published sort keys). - Allowed values: `ID`, `NAME_BRAND`, `YEAR_FOUNDED`, `STATUS_OPERATING`, `UPDATED_AT`, `CREATED_AT`, `TOTAL_RAISED`, `AMOUNT_INVESTED`, `STAGE`, `MOST_RECENT_AMOUNT`, `LATEST_VALUATION`, `MOST_RECENT_DATE`, `ACCELERATOR_BRAND`, `ACCELERATOR_COHORT`, `HEADQUARTERS_COUNTRY`, `EMPLOYEE_COUNT` - `unsupported` (string, optional, nullable) — Constraint the planner could not translate into the canonical EntityFilter contract; null when every material constraint was supported. - `result` (object, required) — Entity list page returned by the canonical entity list engine. - `content` (list of object, required) - `core` (object, required) — Flat entity core — identity, naming, status, image, and source metadata - `id` (string, required) — Unique entity identifier - `image` (object, required) — Logo and monogram image metadata - `isMonogram` (boolean, required) — Whether entity image monogram - `logo` (string, optional, nullable) - `logoSquare` (string, optional, nullable) - `nameAlias` (list of object, required) — All names this entity has been known by — current alternates, DBAs, former names, and rebrand-source identities. Naming history (e.g. `Metaphor Systems` for the current `Exa` entity) lives here; never as a separate relationship type or `formerName` field. - `name` (string, required) — Alternate name text - `displayable` (boolean, optional, nullable) — Show this alias in public name displays. - `type` (enum, optional, nullable) — Alias type classification - Allowed values: `alternativeDba`, `relatedLegal` - `nameBrand` (string, required) — Resolved display brand name - `slug` (string, required) — URL-safe identifier - `createdAt` (datetime, optional, nullable) — Record creation timestamp - `defaultCurrency` (string, optional, nullable) — Default currency code (ISO 4217) - `foundedYear` (integer, optional, nullable) — Year the entity was founded - `lastModifiedAt` (datetime, optional, nullable) — Provenance-grounded last-modified watermark (schema.org dateModified). Advances only when a real, consumer-meaningful data point changes via a recorded provenance event — never on timestamp-only writes, migrations, or index refreshes. Pairs with createdAt (dateCreated) and grounds the sitemap lastmod. - `nameLegal` (string, optional, nullable) — Registered legal name - `operatingStatus` (string, optional, nullable) — Current operating status. Use Acquired Subsidiary when the entity was acquired and still operates; use Acquired only when it is terminal, folded, or closed. - `publicId` (string, optional, nullable) — Stable, immutable public handle (e.g. `eV1StGXR8Z5a`). Never changes once assigned, unlike the slug. Null on projections that do not select it and on rows still awaiting handle backfill. - `publicUrl` (string, optional, nullable) — Absolute public profile URL on the aVenture front-end, e.g. `https://aventure.vc/non-profits/{slug}`, derived from the typeRecord's canonical route family. Null when the route needs relationship context or the record has no direct public SSR route (Business Line, Organization, Product, Service, or a non-public slug). EntityDetail.publicUrl resolves Business Line parent context. Product/Service pages are provider-nested: compose the provider entity's publicUrl + `/products-services/` + this record's slug, or consume the sitemap-urls slot paths, which already emit the composed child routes. - `sitemap` (object, optional, nullable) — Sub-route eligibility, populated by the sitemap projection. Null on non-sitemap reads to keep thin payloads compact. - `hasAnalysis` (boolean, required) — Whether the profile Analysis sub-route should be emitted. - `hasEmployees` (boolean, required) — Whether the profile Employees sub-route should be emitted. - `hasFundraising` (boolean, required) — Whether the profile Fundraising sub-route should be emitted. - `hasNews` (boolean, required) — Whether the profile News sub-route should be emitted. - `productServiceSlug` (list of string, required) — Slugs of related Product/Service entities that should each get their own `/companies//products-services/` URL, capped at `MAX_PRODUCT_SERVICE_SLUGS` server-side. Derived from current `productService` relationships in either stored direction; the entity relationships resource is the authoritative, read-your-writes view of those joins. - `hasAcquisitions` (boolean, optional, default: false) — Whether `/companies//acquisitions` should be emitted. True only when an acquisition relationship exists AND both the acquired and acquirer entities are publicly visible. A confirmed acquisition relationship row with this flag `false` (or with `entities acquisitions list` returning zero rows) means a counterpart entity is still hidden -- publish it -- it is a visibility gate, not list lag. - `typeRecord` (enum, optional, nullable) — Entity type classification - Allowed values: `Company`, `Investment Firm`, `Fund`, `Nonprofit`, `Government`, `Organization`, `Business Line`, `Product`, `Service` - `updatedAt` (datetime, optional, nullable) — Last modification timestamp - `enrichment` (object, required) — Supplemental entity data — addresses, classification tags, funding, text content, and URL links - `address` (list of object, required) - `address` (integer, optional, nullable) — Legacy address row identifier - `addressLine1` (string, optional, nullable) - `addressLine2` (string, optional, nullable) - `association` (list of object, optional) — Role-period associations for this physical address - `id` (integer, required) — Address association row identifier - `isCurrent` (boolean, required) — Whether this role is currently relevant - `endDate` (date, optional, nullable) — Last known day this role applied - `role` (enum, optional, nullable) — Address association role; null means unclassified - `startDate` (date, optional, nullable) — First known day this role applied - `city` (object, optional, nullable) — City reference - `name` (string, required) — City name - `id` (integer, optional, nullable) - `country` (object, optional, nullable) — Country reference - `name` (string, required) — Country name - `countryCodeChar2` (string, optional, nullable) — Two-letter country code - `countryCodeChar3` (string, optional, nullable) — Three-letter country code - `id` (integer, optional, nullable) - `unRegion` (string, optional, nullable) - `unSubregion` (string, optional, nullable) - `countryAbbrev` (string, optional, nullable) - `createdAt` (datetime, optional, nullable) - `fullAddress` (string, optional, nullable) — Single-line formatted address - `id` (integer, optional, nullable) — Address record identifier - `latitude` (double, optional, nullable) - `longitude` (double, optional, nullable) - `postalCode` (string, optional, nullable) - `state` (object, optional, nullable) — State or region reference - `name` (string, required) — State or region name - `id` (integer, optional, nullable) - `stateAbbrev` (string, optional, nullable) — State or region abbreviation - `stateAbbrev` (string, optional, nullable) - `street` (string, optional, nullable) - `updatedAt` (datetime, optional, nullable) - `isCurrent` (boolean, optional, nullable, deprecated) — Deprecated aggregate compatibility flag; true when any association is current - `isHq` (boolean, optional, nullable, deprecated) — Deprecated legacy flag marking the headquarters or legal/registered address - `isPrimary` (boolean, optional, nullable, deprecated) — Deprecated legacy flag marking the primary display address - `classification` (object, required) — Entity classification join projection for this read surface. Single-detail and full-detail batch reads include full history; list, default batch, and similar-entity reads may filter to current joins. Use GET /v1/entities/\{entityId}/classifications?includeInactive=true for authoritative join history. - `geoLocationExposure` (list of object, optional, default: []) — Geographic markets where the entity earns revenue and serves customers (e.g. North America, EMEA, APAC). This is the sales/market footprint classification — NOT the HQ or office location. HQ and office locations belong on the address record (enrichment.address), not this bucket. A London-headquartered company selling globally should have North America and EMEA here, not United Kingdom. - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `industry` (list of object, optional, default: []) — Industry filter values - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `mainProduct` (list of object, optional, default: []) — Main product filter values - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `standardizedClassification` (list of object, optional, default: []) — Standardized classification joins from res_classification_ref. Rows are join-existing-only and carry category/code metadata. - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `category` (string, required) — Standardized category token. - `creatable` (boolean, required) — Standardized taxonomy rows are join-existing-only. - `id` (integer, required) — Standardized classification registry id from res_classification_ref; use as EntityClassificationMutation.classificationId. - `name` (string, required) — Name - `writable` (boolean, required) — Existing standardized rows can be joined through classificationId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `code` (integer, optional, nullable) — Standardized classification code when present. - `createdAt` (datetime, optional, nullable) — Registry row creation timestamp. - `entityClassificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `isCurrent` (boolean, optional, nullable) — Standardized reference rows are current by definition. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within this standardized category. - `level` (integer, optional, nullable) — Hierarchy level when present. - `updatedAt` (datetime, optional, nullable) — Registry row update timestamp. - `tag` (list of object, optional, default: []) — Tag filter values - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `typeCustomer` (list of object, optional, default: []) — Type customer filter values - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `typeModel` (list of object, optional, default: []) — Type model filter values - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `typeOwnership` (list of object, optional, default: []) — Type ownership filter values - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `typeRevenue` (list of object, optional, default: []) — Type revenue filter values - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `typeTechnologyUsed` (list of object, optional, default: []) — Type technology used filter values - `creatable` (boolean, required) - `name` (string, required) — Display name. Capped to the standardized taxonomy storage limit because this shared read contract covers NAICS/SIC/ISIC-style classification labels as well as editorial tags. - `writable` (boolean, required) - `creatable` (boolean, required) — Whether this bucket permits creating missing values by type plus name. - `id` (integer, required) — Classification tag registry id from res_type_ref; use as EntityClassificationMutation.tagId. - `name` (string, required) — Name - `type` (string, required) — Canonical tag classification type - `writable` (boolean, required) — Whether this existing tag can be joined through tagId. - `isCurrent` (boolean, optional, nullable) - `isPrimary` (boolean, optional, nullable) - `bucket` (string, optional, nullable) — Canonical entity-classification bucket key. Use this as EntityClassificationMutation.type when creating by type plus name; `type` remains the registry wire value for tag search and catalog round-trips. - `classificationId` (integer, optional, nullable) — Entity classification join row id for update/delete; present on entity classification responses and null on discovery responses. - `createdAt` (datetime, optional, nullable) — Registry tag creation timestamp, not the entity join timestamp. - `isCurrent` (boolean, optional, nullable) — Current-state flag for this context: registry active flag in discovery, entity join current flag in entity-classification responses. - `isPrimary` (boolean, optional, nullable) — Entity join primary flag within its bucket; null on catalog/tag discovery. - `slug` (string, optional, nullable) — Slug - `updatedAt` (datetime, optional, nullable) — Registry tag update timestamp; join updates return isCurrent/isPrimary but no join updatedAt. - `text` (object, required) — Grouped entity/person text content - `expanded` (string, optional, nullable) — Expanded summary text - `generatedDescription` (string, optional, nullable) — Generated SEO meta description text - `short` (string, optional, nullable) — Short summary text - `urlLink` (list of object, required) — URL link filter values - `url` (string, required) — Canonical absolute HTTP URL value - validates scheme + host at construction - `urlType` (enum, required) — Canonical URL platform type such as website, linkedin, twitter, or github. Lifecycle facts belong on link flags such as isCurrent and isPrimary. - Allowed values: `website`, `linkedin`, `twitter`, `github`, `facebook`, `instagram`, `tiktok`, `youtube`, `subreddit`, `forum`, `documentation`, `support`, `statuspage`, `changelog`, `roadmap`, `discord`, `crunchbase`, `wellfound`, `angellist`, `glassdoor`, `theorg`, `ycombinator`, `wikipedia`, `pitchbook`, `morningstar`, `bloomberg`, `nyse`, `nasdaq`, `g2`, `producthunt`, `trustpilot`, `alternativeto`, `gartnerpeerinsights`, `getapp`, `sourceforge`, `appstore`, `googleplay`, `capterra`, `trustradius`, `hubspotmarketplace`, `slackappdirectory`, `awsmarketplace`, `salesforceappexchange`, `chromewebstore`, `vscodemarketplace`, `npm`, `pypi`, `maven`, `dockerhub`, `homebrew`, `crates` - `crawlCdnProvider` (enum, optional, nullable) — CDN or hosting provider fronting a web URL. - Allowed values: `cloudflare`, `akamai`, `fastly`, `awsCloudfront`, `vercel`, `netlify`, `sucuri`, `incapsula`, `bunny`, `keycdn`, `cdn77`, `gcore`, `cdnetworks`, `azureCdn`, `leaseweb`, `digitalocean`, `stackpath`, `googlecloudCdn`, `none`, `unknown` - `crawlRenderMode` (enum, optional, nullable) — JavaScript rendering requirement for crawl checks. - Allowed values: `static`, `jsRequired`, `jsEnhanced` - `createdAt` (datetime, optional, nullable) - `id` (integer, optional, nullable) - `isCurrent` (boolean, optional, nullable) — `true` = owner currently uses this URL; `false` = historical/former (rebrand source domain, deprecated platform handle). The lifecycle state lives here, NEVER in the `urlType` discriminator. - `isPrimary` (boolean, optional, nullable) — `true` = canonical/primary URL of this `urlType` for this owner. Only one row per (owner, urlType) may be `isCurrent=true` AND `isPrimary=true`. - `owner` (object, optional, nullable) — Owning record, nested ids only: owner.entityId or owner.personId — exactly one is set, and no name fields. Writes are scoped by the owning entity/person route; owner is never a write field. - `entityId` (string, optional, nullable) — Canonical entity UUID - `personId` (string, optional, nullable) — Canonical person UUID - `sourceId` (string, optional, nullable) - `status` (string, optional, nullable) - `statusChecked` (datetime, optional, nullable) - `updatedAt` (datetime, optional, nullable) - `fundingDetail` (object, optional, nullable) — Aggregate view of an entity's fundraising activity - `fundingRoundCount` (integer, required) - `investorCount` (integer, required) - `totalRaised` (double, required) - `latestValuation` (double, optional, nullable) - `mostRecentAmount` (double, optional, nullable) - `mostRecentDate` (date, optional, nullable) - `stage` (enum, optional, nullable) — Canonical inferred equity, entity-type, or Company operating-status stage emitted by the entity fundraise rollup. Transaction classifications such as Debt, IPO, and Acquisition are not entity stages. - Allowed values: `Angel`, `Pre-Seed`, `Seed`, `Series A`, `Series B`, `Series C`, `Series D`, `Series E`, `Series F`, `Series G`, `Series H`, `Series I`, `Series J`, `Series K`, `Series L`, `Series M`, `Series N`, `Series O`, `Series P`, `Series Q`, `Series R`, `Series S`, `Series T`, `Series U`, `Series V`, `Series W`, `Series X`, `Series Y`, `Series Z`, `Investment Firm`, `Fund`, `Nonprofit`, `Government`, `Public`, `Acquired`, `Acquired Subsidiary` - `fundraiseRound` (list of object, required) — Fundraise rounds associated with this entity - `id` (string, required) — Canonical fundraise transaction UUID - `sourceAttribution` (list of object, required) - `attributionType` (enum, required) — How this attribution row participates in the investor view. - Allowed values: `direct`, `managedFund` - `joinId` (string, required) — Fundraise investor join identifier - `leadInvestor` (boolean, required) — Whether this investor is the lead investor for the round — the lead/anchor investor that set the round terms or made the primary commitment. - `transactionId` (string, required) — Fundraise transaction identifier - `amountInvested` (double, optional, nullable) — Investor-level attributed amount invested in the fundraise transaction currency. Serialized as a plain JSON number such as 220000 or 123456.78; no currency sign, currency code, comma grouping, or abbreviated amount text is valid. - `beneficialEntityId` (string, optional, nullable) — Investment firm entity receiving the rollup attribution. - `fundManagerRelationshipId` (integer, optional, nullable) — Fund-manager relationship id when the attribution rolls up through a managed fund. - `recordedEntityId` (string, optional, nullable) — Entity recorded directly on the fundraise investor join. - `round` (object, optional, nullable) — Round label for the attributed participation - `round` (string, required) - `amountRaised` (long, optional, nullable) - `createdAt` (datetime, optional, nullable) - `currency` (string, optional, nullable) - `dataConfidence` (enum, optional, nullable) — Data confidence level - Allowed values: `High`, `Medium`, `Low`, `Verified` - `dateAnnounced` (datetime, optional, nullable) - `dateFundingComplete` (datetime, optional, nullable) - `dateInvestorExit` (datetime, optional, nullable) - `entity` (object, optional, nullable) — Entity projection used inside FundraiseTransaction responses - `core` (object, required) — Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Returned directly by thin-mode (?mode=thin) and alphabetical (?letter=X) list endpoints. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads. - `id` (string, required) — Unique entity identifier - `image` (object, required) — Logo and monogram image metadata - `nameAlias` (list of object, required) — All names this entity has been known by — current alternates, DBAs, former names, and rebrand-source identities. Naming history (e.g. `Metaphor Systems` for the current `Exa` entity) lives here; never as a separate relationship type or `formerName` field. - `nameBrand` (string, required) — Resolved display brand name - `slug` (string, required) — URL-safe identifier - `createdAt` (datetime, optional, nullable) — Record creation timestamp - `defaultCurrency` (string, optional, nullable) — Default currency code (ISO 4217) - `foundedYear` (integer, optional, nullable) — Year the entity was founded - `lastModifiedAt` (datetime, optional, nullable) — Provenance-grounded last-modified watermark (schema.org dateModified). Advances only when a real, consumer-meaningful data point changes via a recorded provenance event — never on timestamp-only writes, migrations, or index refreshes. Pairs with createdAt (dateCreated) and grounds the sitemap lastmod. - `nameLegal` (string, optional, nullable) — Registered legal name - `operatingStatus` (string, optional, nullable) — Current operating status. Use Acquired Subsidiary when the entity was acquired and still operates; use Acquired only when it is terminal, folded, or closed. - `publicId` (string, optional, nullable) — Stable, immutable public handle (e.g. `eV1StGXR8Z5a`). Never changes once assigned, unlike the slug. Null on projections that do not select it and on rows still awaiting handle backfill. - `publicUrl` (string, optional, nullable) — Absolute public profile URL on the aVenture front-end, e.g. `https://aventure.vc/non-profits/{slug}`, derived from the typeRecord's canonical route family. Null when the route needs relationship context or the record has no direct public SSR route (Business Line, Organization, Product, Service, or a non-public slug). EntityDetail.publicUrl resolves Business Line parent context. Product/Service pages are provider-nested: compose the provider entity's publicUrl + `/products-services/` + this record's slug, or consume the sitemap-urls slot paths, which already emit the composed child routes. - `sitemap` (object, optional, nullable) — Sub-route eligibility, populated by the sitemap projection. Null on non-sitemap reads to keep thin payloads compact. - `typeRecord` (enum, optional, nullable) — Entity type classification - `updatedAt` (datetime, optional, nullable) — Last modification timestamp - `fundingDetail` (object, optional, nullable) — Aggregate view of an entity's fundraising activity - `fundingRoundCount` (integer, required) - `investorCount` (integer, required) - `totalRaised` (double, required) - `latestValuation` (double, optional, nullable) - `mostRecentAmount` (double, optional, nullable) - `mostRecentDate` (date, optional, nullable) - `stage` (enum, optional, nullable) — Canonical inferred equity, entity-type, or Company operating-status stage emitted by the entity fundraise rollup. Transaction classifications such as Debt, IPO, and Acquisition are not entity stages. - `investorAttribution` (object, optional, nullable) — Investor-specific attribution when returned from investor-perspective investment views. amountInvested is not added to amountRaised; it is the selected investor's attributed participation amount for this round. - `attributionType` (enum, required) — How this attribution row participates in the investor view. - Allowed values: `direct`, `managedFund` - `joinId` (string, required) — Fundraise investor join identifier - `leadInvestor` (boolean, required) — Whether this investor is the lead investor for the round — the lead/anchor investor that set the round terms or made the primary commitment. - `transactionId` (string, required) — Fundraise transaction identifier - `amountInvested` (double, optional, nullable) — Investor-level attributed amount invested in the fundraise transaction currency. Serialized as a plain JSON number such as 220000 or 123456.78; no currency sign, currency code, comma grouping, or abbreviated amount text is valid. - `beneficialEntityId` (string, optional, nullable) — Investment firm entity receiving the rollup attribution. - `fundManagerRelationshipId` (integer, optional, nullable) — Fund-manager relationship id when the attribution rolls up through a managed fund. - `recordedEntityId` (string, optional, nullable) — Entity recorded directly on the fundraise investor join. - `round` (object, optional, nullable) — Round label for the attributed participation - `round` (string, required) - `investorCount` (integer, optional, nullable) — Source-reported number of investors in the round. This can exceed the identified investor joins when a source reports a total without naming every investor. - `round` (string, optional, nullable) - `updatedAt` (datetime, optional, nullable) - `valuationPostMoney` (long, optional, nullable) - `valuationPreMoney` (long, optional, nullable) - `research` (object, required) — List-safe research disclosure without text snippets - `acceleratorParticipation` (list of object, required) — Joined accelerator participation derived from governed accelerator research rows - `accelerator` (object, required) — Canonical thin accelerator entity from the acceleratorParticipant relationship - `id` (string, required) — Unique entity identifier - `image` (object, required) — Logo and monogram image metadata - `nameAlias` (list of object, required) — All names this entity has been known by — current alternates, DBAs, former names, and rebrand-source identities. Naming history (e.g. `Metaphor Systems` for the current `Exa` entity) lives here; never as a separate relationship type or `formerName` field. - `nameBrand` (string, required) — Resolved display brand name - `slug` (string, required) — URL-safe identifier - `createdAt` (datetime, optional, nullable) — Record creation timestamp - `defaultCurrency` (string, optional, nullable) — Default currency code (ISO 4217) - `foundedYear` (integer, optional, nullable) — Year the entity was founded - `lastModifiedAt` (datetime, optional, nullable) — Provenance-grounded last-modified watermark (schema.org dateModified). Advances only when a real, consumer-meaningful data point changes via a recorded provenance event — never on timestamp-only writes, migrations, or index refreshes. Pairs with createdAt (dateCreated) and grounds the sitemap lastmod. - `nameLegal` (string, optional, nullable) — Registered legal name - `operatingStatus` (string, optional, nullable) — Current operating status. Use Acquired Subsidiary when the entity was acquired and still operates; use Acquired only when it is terminal, folded, or closed. - `publicId` (string, optional, nullable) — Stable, immutable public handle (e.g. `eV1StGXR8Z5a`). Never changes once assigned, unlike the slug. Null on projections that do not select it and on rows still awaiting handle backfill. - `publicUrl` (string, optional, nullable) — Absolute public profile URL on the aVenture front-end, e.g. `https://aventure.vc/non-profits/{slug}`, derived from the typeRecord's canonical route family. Null when the route needs relationship context or the record has no direct public SSR route (Business Line, Organization, Product, Service, or a non-public slug). EntityDetail.publicUrl resolves Business Line parent context. Product/Service pages are provider-nested: compose the provider entity's publicUrl + `/products-services/` + this record's slug, or consume the sitemap-urls slot paths, which already emit the composed child routes. - `sitemap` (object, optional, nullable) — Sub-route eligibility, populated by the sitemap projection. Null on non-sitemap reads to keep thin payloads compact. - `typeRecord` (enum, optional, nullable) — Entity type classification - `updatedAt` (datetime, optional, nullable) — Last modification timestamp - `acceleratorName` (string, required) — Full accelerator participation name, including program detail - `asOfDate` (datetime, required) — Participation effective timestamp - `id` (string, required) — Stable participation identifier anchored to the contributing acceleratorParticipant relationship - `batch` (string, optional, nullable) — Accelerator batch or cohort - `program` (string, optional, nullable) — Accelerator program name, when the source distinguishes one - `status` (string, optional, nullable) — Accelerator participation status - `detail` (list of object, required) — Flat governed research detail rows filtered by visibility - `entityId` (string, required) — Canonical entity UUID - `id` (integer, required) - `typeResearchDetail` (string, required) - `valueType` (enum, required) — Output kind for governed research detail values - Allowed values: `text`, `numeric`, `monetary`, `percentage`, `date` - `asOfDate` (datetime, optional, nullable) - `createdAt` (datetime, optional, nullable) - `creator` (string, optional, nullable) - `dataConfidence` (enum, optional, nullable) — Confidence tier stored verbatim in res_entity_detail.data_confidence. - Allowed values: `low`, `medium`, `high` - `derivedRange` (object, optional, nullable) — Read-only range derived only for targetDateAbsolute detail rows - `asOfDate` (datetime, required) — Observation timestamp from the source detail row - `bucket` (enum, required) — Derived bucket using inclusive 0, 3, 6, 12, and 24 month boundaries - `monthsFromNow` (integer, required) — Whole months from now() to targetDate - `targetDate` (datetime, required) — Absolute target date stored for a targetDateAbsolute detail row - `discreteValue` (double, optional, nullable) - `textValue` (string, optional, nullable) - `updatedAt` (datetime, optional, nullable) - `valueResearchDetail` (string, optional, nullable) - `semanticMatch` (object, optional, nullable) — Semantic embedding match evidence populated only for semantic list reads. - `computedAt` (datetime, required) — Timestamp when the embedding row was computed. - `cosineDistance` (double, required) — pgvector cosine distance where lower is closer. - `cosineScore` (double, required) — Cosine similarity score where higher is closer. - `modelVersion` (string, required) — Embedding model/profile version for this row. - `rank` (integer, required) — One-based semantic rank within the returned ANN candidate set. - `sourceHash` (string, required) — SHA-256 hash of the source content. - `sourceId` (string, required) — Content embedding source identifier. - `sourceJson` (string, required) — Serialized JSONB source document stored for the embedding row. - `sourceText` (string, required) — Source text used to compute the stored embedding. - `sourceType` (enum, required) — Stored content embedding source partition. - Allowed values: `entity`, `person`, `newsArticle`, `blogPost`, `text`, `classificationTag`, `classificationCode`, `product`, `service`, `agentHelpDoc` - `number` (integer, required) - `size` (integer, required) - `totalElements` (long, required) - `totalPages` (integer, required) - `news` (object, required) — Canonical news page returned by the keyword list engine. - `content` (list of object, required) - `id` (integer, required) — Type-safe identifier for news articles - `title` (string, required) — Article headline; the headline field is title - `author` (string, optional, nullable) - `category` (string, optional, nullable) - `createdAt` (datetime, optional, nullable) - `excerpt` (string, optional, nullable) — Article summary from the source publication feed; null means the feed supplied no description (expected absence, not an error) — full text is NewsDetail.content - `externalNewsArticle` (boolean, optional, nullable) - `newsImageThumbnail` (string, optional, nullable) - `newsUrlOriginal` (string, optional, nullable) - `pendingApproval` (integer, optional, nullable) - `publication` (string, optional, nullable) - `publishedAt` (datetime, optional, nullable) - `slug` (string, optional, nullable) — Canonical lowercase URL slug for the resource - `updatedAt` (datetime, optional, nullable) - `number` (integer, required) - `size` (integer, required) - `totalElements` (long, required) - `totalPages` (integer, required) - `person` (object, required) — Canonical person natural-search result. - `interpretation` (object, required) — Structured interpretation used to run the people query. - `confidence` (enum, required) — Planner confidence in the structured interpretation. - Allowed values: `HIGH`, `MEDIUM`, `LOW` - `execution` (object, required) — Requested and executed search strategy. - `modeRequested` (enum, required) — Search mode requested by the caller. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `modeUsed` (enum, required) — Search mode executed by the canonical engine. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `fallbackUsed` (boolean, required) — True when the semantic fallback replaced an unconstrained planner result with a semantic search over the original query. - `filter` (object, required) — Canonical person filter generated from the natural-language query. - `arrayFilter` (object, optional) — Array and range filters - `amountInvestedRange` (list of object, optional, nullable) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `amountRaisedRange` (list of object, optional, nullable) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `entityName` (list of string, optional, nullable) — Associated entity names. - `investedCompany` (list of string, optional, nullable) — Invested company names. - `personTitle` (list of string, optional, nullable) — Person titles. - `round` (list of string, optional, nullable) — Fundraise round labels. - `totalInvestmentCount` (list of object, optional, nullable) - `max` (integer, optional, nullable) — Inclusive maximum integer. - `min` (integer, optional, nullable) — Inclusive minimum integer. - `typeRecord` (list of enum, optional, nullable) — Associated entity type scope. Omit or use [] for any associated type. - Allowed values: `Company`, `Investment Firm`, `Fund`, `Nonprofit`, `Government`, `Organization`, `Business Line`, `Product`, `Service` - `entityId` (string, optional, nullable) — Associated entity UUID. - `entitySlug` (string, optional, nullable) — Associated entity slug. - `firstName` (string, optional, nullable) — Person first name. - `includeAddress` (boolean, optional, nullable) — Include addresses on each person - `includeUrl` (boolean, optional, nullable) — Include URL links on each person - `investorActivity` (object, optional) — Aggregate investor activity filters. - `averageAmountInvestedUsdRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `largestAmountInvestedUsdRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `smallestAmountInvestedUsdRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `totalAmountInvestedUsdRange` (list of object, optional) - `max` (double, optional, nullable) — Inclusive maximum decimal number, such as 220000 or 123456.78. - `min` (double, optional, nullable) — Inclusive minimum decimal number, such as 220000 or 123456.78. - `totalInvestmentRange` (list of object, optional) - `max` (integer, optional, nullable) — Inclusive maximum integer. - `min` (integer, optional, nullable) — Inclusive minimum integer. - `isCurrent` (boolean, optional, nullable) — Filter current associations. - `lastName` (string, optional, nullable) — Person last name. - `letter` (string, optional, nullable) — First-name initial. - `role` (string, optional, nullable) — Associated entity role or title. - `search` (string, optional, nullable) — Search keyword or phrase. Single characters valid; stop words rejected. - `semanticQuery` (string, optional, nullable) — Semantic person search phrase. - `status` (string, optional, nullable) — Person workflow status. - `interpretation` (string, required) — Human-readable summary of how the query was interpreted. - `sort` (object, required) — Sort applied to the result page. Empty when the page was ordered by semantic relevance rank instead of a sortable column. - `order` (list of object, required) — Ordered sort terms. Empty list means unspecified at the HTTP boundary (defaults apply). - `descending` (boolean, required) — true for descending (DESC), false for ascending (ASC) - `field` (enum, required) — Sort field for this resource (entity list uses EntityFilter.Sortable / published sort keys). - Allowed values: `ID`, `FIRST_NAME`, `LAST_NAME`, `FULL_NAME`, `SLUG`, `CREATED_AT`, `UPDATED_AT`, `STATUS`, `GENDER`, `AMOUNT_INVESTED`, `TOTAL_INVESTMENTS` - `unsupported` (string, optional, nullable) — Constraint the planner could not translate into the canonical PersonFilter contract; null when every material constraint was supported. - `result` (object, required) — Person page returned by the canonical person list engine. - `content` (list of object, required) - `id` (string, required) — Canonical person UUID - `image` (object, required) — Read projection: person image fields for detail/list responses - `isMonogram` (boolean, required) — Whether person image monogram - `picture` (string, optional, nullable) - `nameAlias` (list of object, required) — Display and search aliases for this person - `name` (string, required) — Alternate name text - `displayable` (boolean, optional, nullable) — Show this alias in public name displays. - `type` (enum, optional, nullable) — Alias type classification - Allowed values: `nickname`, `maidenName`, `formerName`, `stageName` - `nameFull` (string, required) - `slug` (string, required) — Canonical lowercase URL slug for the resource - `source` (object, required) — Grouped source/provenance metadata for private v1 response fields - `changedAt` (datetime, optional, nullable) - `dataSourceUpdatedAt` (datetime, optional, nullable) - `detail` (string, optional, nullable) - `kind` (string, optional, nullable) - `pendingApproval` (integer, optional, nullable) - `sourceId` (string, optional, nullable) - `status` (string, optional, nullable) - `text` (object, required) — Grouped person text content - `expanded` (string, optional, nullable) — Expanded summary text - `generatedDescription` (string, optional, nullable) — Generated SEO meta description text - `short` (string, optional, nullable) — Short summary text - `createdAt` (datetime, optional, nullable) — Record creation timestamp - `gender` (string, optional, nullable) - `lastModifiedAt` (datetime, optional, nullable) — Provenance-grounded last-modified watermark (schema.org dateModified): the latest effective time across all writes attributed to this person. - `nameFirst` (string, optional, nullable) - `nameLast` (string, optional, nullable) - `nameMiddle` (string, optional, nullable) - `nickname` (string, optional, nullable) - `publicId` (string, optional, nullable) — Stable, immutable public handle (e.g. `pV1StGXR8Z5ab`). Never changes once assigned, unlike the slug. Null on projections that do not select it and on rows still awaiting handle backfill. - `semanticMatch` (object, optional, nullable) — Semantic embedding match evidence populated only for semantic people reads. - `computedAt` (datetime, required) — Timestamp when the embedding row was computed. - `cosineDistance` (double, required) — pgvector cosine distance where lower is closer. - `cosineScore` (double, required) — Cosine similarity score where higher is closer. - `modelVersion` (string, required) — Embedding model/profile version for this row. - `rank` (integer, required) — One-based semantic rank within the returned ANN candidate set. - `sourceHash` (string, required) — SHA-256 hash of the source content. - `sourceId` (string, required) — Content embedding source identifier. - `sourceJson` (string, required) — Serialized JSONB source document stored for the embedding row. - `sourceText` (string, required) — Source text used to compute the stored embedding. - `sourceType` (enum, required) — Stored content embedding source partition. - Allowed values: `entity`, `person`, `newsArticle`, `blogPost`, `text`, `classificationTag`, `classificationCode`, `product`, `service`, `agentHelpDoc` - `suffix` (string, optional, nullable) - `updatedAt` (datetime, optional, nullable) — Last modification timestamp - `number` (integer, required) - `size` (integer, required) - `totalElements` (long, required) - `totalPages` (integer, required) - `provenance` (object, required) — Requested and executed strategy for each search scope. - `entity` (object, required) — Entity search strategy execution. - `modeRequested` (enum, required) — Search mode requested by the caller. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `modeUsed` (enum, required) — Search mode executed by the canonical engine. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `news` (object, required) — News search strategy execution. - `modeRequested` (enum, required) — Search mode requested by the caller. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `modeUsed` (enum, required) — Search mode executed by the canonical engine. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `person` (object, required) — Person search strategy execution. - `modeRequested` (enum, required) — Search mode requested by the caller. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` - `modeUsed` (enum, required) — Search mode executed by the canonical engine. - Allowed values: `auto`, `exact`, `keyword`, `semantic`, `natural` ## Examples **Request** ```json { "query": "Companies founded in the last year that raised venture capital" } ``` **Response** ```json { "entity": { "interpretation": { "confidence": "HIGH", "execution": { "modeRequested": "auto", "modeUsed": "auto" }, "fallbackUsed": true, "filter": { "acceleratorBrand": [ "string" ], "acceleratorCohort": [ "string" ], "acceleratorName": [ "string" ], "acceleratorStatus": [ "string" ], "affinity": [ "string" ], "employeeCountRange": [ { "max": 1, "min": 1 } ], "entityId": [ "string" ], "entityName": [ "string" ], "featured": true, "fundraiseActivity": { "amountInvestedRange": [ { "max": 1.1, "min": 1.1 } ], "amountRaisedRange": [ { "max": 1.1, "min": 1.1 } ], "investedCompanyName": [ "string" ], "investorActivity": { "averageAmountInvestedUsdRange": [ { "max": 1.1, "min": 1.1 } ], "largestAmountInvestedUsdRange": [ { "max": 1.1, "min": 1.1 } ], "smallestAmountInvestedUsdRange": [ { "max": 1.1, "min": 1.1 } ], "totalAmountInvestedUsdRange": [ { "max": 1.1, "min": 1.1 } ], "totalInvestmentRange": [ { "max": 1, "min": 1 } ] }, "lastRoundYearRange": [ { "max": 1, "min": 1 } ], "round": [ "string" ], "totalRaisedRange": [ { "max": 1.1, "min": 1.1 } ], "valuationRange": [ { "max": 1.1, "min": 1.1 } ] }, "hasFundraising": true, "headquartersCity": [ "string" ], "headquartersCountry": [ "string" ], "headquartersState": [ "string" ], "industry": [ "string" ], "letter": "string", "location": [ "string" ], "logoOption": { "sortPriority": "NONE" }, "mainProduct": [ "string" ], "operatingStatus": [ "string" ], "portfolioHeadquartersCity": [ "string" ], "portfolioHeadquartersCountry": [ "string" ], "portfolioHeadquartersState": [ "string" ], "qualityGate": "NONE", "semanticQuery": "string", "slug": [ "aventure-vc" ], "stage": [ "string" ], "suppressNonOperating": true, "suppressZeroTotalRaised": true, "tag": [ "string" ], "textSearch": "string", "typeCustomer": [ "string" ], "typeModel": [ "string" ], "typeOwnership": [ "string" ], "typeRecord": [ "Company" ], "typeRevenue": [ "string" ], "typeTechnologyUsed": [ "string" ], "url": "string", "urlDomain": "example.com", "urlMatchMode": "domain", "urlType": "website", "yearFoundedRange": [ { "max": 1, "min": 1 } ] }, "interpretation": "string", "sort": { "order": [ { "descending": true, "field": "ID" } ] }, "unsupported": "string" }, "result": { "content": [ { "core": { "id": "string", "image": { "isMonogram": true, "logo": "string", "logoSquare": "string" }, "nameAlias": [ { "name": "Bun", "displayable": true, "type": "alternativeDba" } ], "nameBrand": "string", "slug": "aventure-vc", "createdAt": "2024-01-15T09:30:00Z", "defaultCurrency": "string", "foundedYear": 1, "lastModifiedAt": "2024-01-15T09:30:00Z", "nameLegal": "string", "operatingStatus": "string", "publicId": "eV1StGXR8Z5a", "publicUrl": "string", "sitemap": { "hasAnalysis": true, "hasEmployees": true, "hasFundraising": true, "hasNews": true, "productServiceSlug": [ "string" ], "hasAcquisitions": false }, "typeRecord": "Company", "updatedAt": "2024-01-15T09:30:00Z" }, "enrichment": { "address": [ { "address": 456, "addressLine1": "string", "addressLine2": "string", "association": [ { "id": 123, "isCurrent": true, "endDate": "2023-01-15", "role": "domicile", "startDate": "2023-01-15" } ], "city": { "name": "Boston", "id": 1 }, "country": { "name": "United States", "countryCodeChar2": "US", "countryCodeChar3": "USA", "id": 1, "unRegion": "string", "unSubregion": "string" }, "countryAbbrev": "string", "createdAt": "2024-01-15T09:30:00Z", "fullAddress": "123 Main St, Boston, MA 02110, USA", "id": 123, "latitude": 1.1, "longitude": 1.1, "postalCode": "string", "state": { "name": "Massachusetts", "id": 1, "stateAbbrev": "MA" }, "stateAbbrev": "string", "street": "string", "updatedAt": "2024-01-15T09:30:00Z", "isCurrent": true, "isHq": true, "isPrimary": true } ], "classification": { "geoLocationExposure": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "industry": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "mainProduct": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "standardizedClassification": [ { "creatable": true, "name": "string", "writable": true, "category": "string", "id": 1, "isCurrent": true, "isPrimary": true, "code": 1, "createdAt": "2024-01-15T09:30:00Z", "entityClassificationId": 1, "level": 1, "updatedAt": "2024-01-15T09:30:00Z" } ], "tag": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "typeCustomer": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "typeModel": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "typeOwnership": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "typeRevenue": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "typeTechnologyUsed": [ { "creatable": true, "name": "string", "writable": true, "id": 1, "type": "industry", "isCurrent": true, "isPrimary": true, "bucket": "string", "classificationId": 1, "createdAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ] }, "text": { "expanded": "Canonical expanded summary for grouped text assertions.", "generatedDescription": "Acme AI builds AI copilots for growth teams.", "short": "Canonical short summary" }, "urlLink": [ { "url": "https://example.com", "urlType": "website", "crawlCdnProvider": "cloudflare", "crawlRenderMode": "static", "createdAt": "2024-01-15T09:30:00Z", "id": 1, "isCurrent": true, "isPrimary": true, "owner": { "entityId": "string", "personId": "string" }, "sourceId": "string", "status": "string", "statusChecked": "2024-01-15T09:30:00Z", "updatedAt": "2024-01-15T09:30:00Z" } ], "fundingDetail": { "fundingRoundCount": 1, "investorCount": 1, "totalRaised": 1.1, "latestValuation": 1.1, "mostRecentAmount": 1.1, "mostRecentDate": "2023-01-15", "stage": "Angel" } }, "fundraiseRound": [ { "id": "string", "sourceAttribution": [ { "attributionType": "direct", "joinId": "string", "leadInvestor": true, "transactionId": "string", "amountInvested": 1.1, "beneficialEntityId": "string", "fundManagerRelationshipId": 1, "recordedEntityId": "string", "round": { "round": "string" } } ], "amountRaised": 1, "createdAt": "2024-01-15T09:30:00Z", "currency": "string", "dataConfidence": "High", "dateAnnounced": "2024-01-15T09:30:00Z", "dateFundingComplete": "2024-01-15T09:30:00Z", "dateInvestorExit": "2024-01-15T09:30:00Z", "entity": { "core": { "id": "string", "image": { "isMonogram": true, "logo": "string", "logoSquare": "string" }, "nameAlias": [ { "name": "Bun", "displayable": true, "type": "alternativeDba" } ], "nameBrand": "string", "slug": "aventure-vc", "createdAt": "2024-01-15T09:30:00Z", "defaultCurrency": "string", "foundedYear": 1, "lastModifiedAt": "2024-01-15T09:30:00Z", "nameLegal": "string", "operatingStatus": "string", "publicId": "eV1StGXR8Z5a", "publicUrl": "string", "sitemap": { "hasAnalysis": true, "hasEmployees": true, "hasFundraising": true, "hasNews": true, "productServiceSlug": [ "string" ], "hasAcquisitions": false }, "typeRecord": "Company", "updatedAt": "2024-01-15T09:30:00Z" }, "fundingDetail": { "fundingRoundCount": 1, "investorCount": 1, "totalRaised": 1.1, "latestValuation": 1.1, "mostRecentAmount": 1.1, "mostRecentDate": "2023-01-15", "stage": "Angel" } }, "investorAttribution": { "attributionType": "direct", "joinId": "string", "leadInvestor": true, "transactionId": "string", "amountInvested": 1.1, "beneficialEntityId": "string", "fundManagerRelationshipId": 1, "recordedEntityId": "string", "round": { "round": "string" } }, "investorCount": 1, "round": "string", "updatedAt": "2024-01-15T09:30:00Z", "valuationPostMoney": 1, "valuationPreMoney": 1 } ], "research": { "acceleratorParticipation": [ { "accelerator": { "id": "string", "image": { "isMonogram": true, "logo": "string", "logoSquare": "string" }, "nameAlias": [ { "name": "Bun", "displayable": true, "type": "alternativeDba" } ], "nameBrand": "string", "slug": "aventure-vc", "createdAt": "2024-01-15T09:30:00Z", "defaultCurrency": "string", "foundedYear": 1, "lastModifiedAt": "2024-01-15T09:30:00Z", "nameLegal": "string", "operatingStatus": "string", "publicId": "eV1StGXR8Z5a", "publicUrl": "string", "sitemap": { "hasAnalysis": true, "hasEmployees": true, "hasFundraising": true, "hasNews": true, "productServiceSlug": [ "string" ], "hasAcquisitions": false }, "typeRecord": "Company", "updatedAt": "2024-01-15T09:30:00Z" }, "acceleratorName": "string", "asOfDate": "2024-01-15T09:30:00Z", "id": "string", "batch": "string", "program": "string", "status": "string" } ], "detail": [ { "entityId": "string", "id": 1, "typeResearchDetail": "string", "valueType": "text", "asOfDate": "2024-01-15T09:30:00Z", "createdAt": "2024-01-15T09:30:00Z", "creator": "string", "dataConfidence": "low", "derivedRange": { "asOfDate": "2024-01-15T09:30:00Z", "bucket": "pastDue", "monthsFromNow": 1, "targetDate": "2024-01-15T09:30:00Z" }, "discreteValue": 1.1, "textValue": "string", "updatedAt": "2024-01-15T09:30:00Z", "valueResearchDetail": "string" } ] }, "semanticMatch": { "computedAt": "2024-01-15T09:30:00Z", "cosineDistance": 1.1, "cosineScore": 1.1, "modelVersion": "string", "rank": 1, "sourceHash": "string", "sourceId": "string", "sourceJson": "string", "sourceText": "string", "sourceType": "entity" } } ], "number": 1, "size": 1, "totalElements": 1, "totalPages": 1 } }, "news": { "content": [ { "id": 1, "title": "string", "author": "string", "category": "string", "createdAt": "2024-01-15T09:30:00Z", "excerpt": "string", "externalNewsArticle": true, "newsImageThumbnail": "string", "newsUrlOriginal": "string", "pendingApproval": 1, "publication": "string", "publishedAt": "2024-01-15T09:30:00Z", "slug": "aventure-vc", "updatedAt": "2024-01-15T09:30:00Z" } ], "number": 1, "size": 1, "totalElements": 1, "totalPages": 1 }, "person": { "interpretation": { "confidence": "HIGH", "execution": { "modeRequested": "auto", "modeUsed": "auto" }, "fallbackUsed": true, "filter": { "arrayFilter": { "amountInvestedRange": [ { "max": 1.1, "min": 1.1 } ], "amountRaisedRange": [ { "max": 1.1, "min": 1.1 } ], "entityName": [ "string" ], "investedCompany": [ "string" ], "personTitle": [ "string" ], "round": [ "string" ], "totalInvestmentCount": [ { "max": 1, "min": 1 } ], "typeRecord": [ "Company" ] }, "entityId": "string", "entitySlug": "string", "firstName": "string", "includeAddress": true, "includeUrl": true, "investorActivity": { "averageAmountInvestedUsdRange": [ { "max": 1.1, "min": 1.1 } ], "largestAmountInvestedUsdRange": [ { "max": 1.1, "min": 1.1 } ], "smallestAmountInvestedUsdRange": [ { "max": 1.1, "min": 1.1 } ], "totalAmountInvestedUsdRange": [ { "max": 1.1, "min": 1.1 } ], "totalInvestmentRange": [ { "max": 1, "min": 1 } ] }, "isCurrent": true, "lastName": "string", "letter": "A", "role": "string", "search": "AI", "semanticQuery": "string", "status": "string" }, "interpretation": "string", "sort": { "order": [ { "descending": true, "field": "ID" } ] }, "unsupported": "string" }, "result": { "content": [ { "id": "string", "image": { "isMonogram": true, "picture": "string" }, "nameAlias": [ { "name": "Bun", "displayable": true, "type": "nickname" } ], "nameFull": "string", "slug": "aventure-vc", "source": { "changedAt": "2024-01-15T09:30:00Z", "dataSourceUpdatedAt": "2024-01-15T09:30:00Z", "detail": "string", "kind": "string", "pendingApproval": 1, "sourceId": "string", "status": "string" }, "text": { "expanded": "Canonical expanded summary for grouped text assertions.", "generatedDescription": "Acme AI builds AI copilots for growth teams.", "short": "Canonical short summary" }, "createdAt": "2024-01-15T09:30:00Z", "gender": "string", "lastModifiedAt": "2024-01-15T09:30:00Z", "nameFirst": "string", "nameLast": "string", "nameMiddle": "string", "nickname": "string", "publicId": "pV1StGXR8Z5ab", "semanticMatch": { "computedAt": "2024-01-15T09:30:00Z", "cosineDistance": 1.1, "cosineScore": 1.1, "modelVersion": "string", "rank": 1, "sourceHash": "string", "sourceId": "string", "sourceJson": "string", "sourceText": "string", "sourceType": "entity" }, "suffix": "string", "updatedAt": "2024-01-15T09:30:00Z" } ], "number": 1, "size": 1, "totalElements": 1, "totalPages": 1 } }, "provenance": { "entity": { "modeRequested": "auto", "modeUsed": "auto" }, "news": { "modeRequested": "auto", "modeUsed": "auto" }, "person": { "modeRequested": "auto", "modeUsed": "auto" } } } ``` **SDK Code** ```python import requests url = "https://api.aventure.vc/v1/search/all" payload = { "query": "Companies founded in the last year that raised venture capital" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.aventure.vc/v1/search/all'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"query":"Companies founded in the last year that raised venture capital"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.aventure.vc/v1/search/all" payload := strings.NewReader("{\n \"query\": \"Companies founded in the last year that raised venture capital\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.aventure.vc/v1/search/all") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"query\": \"Companies founded in the last year that raised venture capital\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.aventure.vc/v1/search/all") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"query\": \"Companies founded in the last year that raised venture capital\"\n}") .asString(); ``` ```php request('POST', 'https://api.aventure.vc/v1/search/all', [ 'body' => '{ "query": "Companies founded in the last year that raised venture capital" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.aventure.vc/v1/search/all"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"query\": \"Companies founded in the last year that raised venture capital\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["query": "Companies founded in the last year that raised venture capital"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.aventure.vc/v1/search/all")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```