> 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 from a shared article or page URL

GET https://api.aventure.vc/v1/search/link

Fetches the page at the supplied URL, identifies the single company, product, or person the page is primarily about, and returns the federated entity, person, and news results for that name together with the synthesized query itself. A page whose content cannot be read returns 404; a fetch or inference failure returns 503, never an empty result. For direct URL-to-record identity resolution use the entities get operation (GET /v1/entities/detail?url=...) instead.

Reference: https://docs.aventure.vc/api-reference/a-venture-api/search/link

## Authentication

- `X-Client-Secret` header (required) — Client secret for read-only service-to-service access (no writes)

## Request

### Query parameters

- `url` (string, required) — Public article or page URL to search from
- `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.

## Response

### 200

OK

- `query` (string, required) — Search query synthesized from the page content.
- `related` (object, required) — Federated entity, person, and news results for the synthesized query.
  - `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)
            - `largestAmountInvestedUsdRange` (list of object, optional)
            - `smallestAmountInvestedUsdRange` (list of object, optional)
            - `totalAmountInvestedUsdRange` (list of object, optional)
            - `totalInvestmentRange` (list of object, optional)
          - `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
          - `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/<slug>/products-services/<productSlug>` 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/<slug>/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
            - `city` (object, optional, nullable) — City reference
            - `country` (object, optional, nullable) — Country reference
            - `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
            - `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.
            - `industry` (list of object, optional, default: []) — Industry filter values
            - `mainProduct` (list of object, optional, default: []) — Main product filter values
            - `standardizedClassification` (list of object, optional, default: []) — Standardized classification joins from res_classification_ref. Rows are join-existing-only and carry category/code metadata.
            - `tag` (list of object, optional, default: []) — Tag filter values
            - `typeCustomer` (list of object, optional, default: []) — Type customer filter values
            - `typeModel` (list of object, optional, default: []) — Type model filter values
            - `typeOwnership` (list of object, optional, default: []) — Type ownership filter values
            - `typeRevenue` (list of object, optional, default: []) — Type revenue filter values
            - `typeTechnologyUsed` (list of object, optional, default: []) — Type technology used filter values
          - `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.
            - `crawlCdnProvider` (enum, optional, nullable) — CDN or hosting provider fronting a web URL.
            - `crawlRenderMode` (enum, optional, nullable) — JavaScript rendering requirement for crawl checks.
            - `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.
            - `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.
        - `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.
            - `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
          - `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.
            - `fundingDetail` (object, optional, nullable) — Aggregate view of an entity's fundraising activity
          - `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.
            - `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
          - `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
            - `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
            - `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.
            - `derivedRange` (object, optional, nullable) — Read-only range derived only for targetDateAbsolute detail rows
            - `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`
- `url` (string, required) — The fetched page URL after validation.

## Examples

**Response**

```json
{
  "query": "string",
  "related": {
    "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"
      }
    }
  },
  "url": "https://example.com/article"
}
```

**SDK Code**

```python
import requests

url = "https://api.aventure.vc/v1/search/link"

querystring = {"url":"https://example.com/article"}

headers = {"X-Client-Secret": "<apiKey>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript
const url = 'https://api.aventure.vc/v1/search/link?url=https%3A%2F%2Fexample.com%2Farticle';
const options = {method: 'GET', headers: {'X-Client-Secret': '<apiKey>'}};

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"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aventure.vc/v1/search/link?url=https%3A%2F%2Fexample.com%2Farticle"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Client-Secret", "<apiKey>")

	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/link?url=https%3A%2F%2Fexample.com%2Farticle")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Client-Secret"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.aventure.vc/v1/search/link?url=https%3A%2F%2Fexample.com%2Farticle")
  .header("X-Client-Secret", "<apiKey>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.aventure.vc/v1/search/link?url=https%3A%2F%2Fexample.com%2Farticle', [
  'headers' => [
    'X-Client-Secret' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.aventure.vc/v1/search/link?url=https%3A%2F%2Fexample.com%2Farticle");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Client-Secret", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["X-Client-Secret": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.aventure.vc/v1/search/link?url=https%3A%2F%2Fexample.com%2Farticle")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

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()
```