Search Content | aVenture Developer Docs

curl -X POST https://api.aventure.vc/v1/content/search \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "query": "Companies founded in the last year that raised venture capital"
}'

{
  "content": [
    {
      "contentId": "string",
      "contentType": "newsArticle",
      "title": "string",
      "canonicalUrl": "string",
      "createdAt": "2024-01-15T09:30:00Z",
      "publishedAt": "2024-01-15T09:30:00Z",
      "relation": "by",
      "sourceDomain": "string",
      "sourceName": "string",
      "summary": "string",
      "topic": "string",
      "updatedAt": "2024-01-15T09:30:00Z",
      "url": "string",
      "year": 1
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 1,
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 1,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 1,
  "totalPages": 1
}

Searches news, posts, repositories, sites, and papers published by or about one company (ownerEntityId) or person (ownerPersonId) from a plain-English query; omit both owners to search every owner’s content. Any signed-in user may call this.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Query parameters

ownerEntityIdstringOptionalformat: "uuid"

Company whose publications to read; mutually exclusive with ownerPersonId.

ownerPersonIdstringOptionalformat: "uuid"

Person whose publications to read; mutually exclusive with ownerEntityId.

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 20

The size of the page to be returned

sortlist of stringsOptional

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

Request

This endpoint expects an object.

querystringRequired>=1 character

Plain-English search request.

answerModelstring or nullOptional

Optional supported model id for the written answer, which also supplies the page heading, title, and description. Leave the field out for the server’s model; a value that is not a supported model id answers 422.

cacheModeenumOptional

Cache policy. use reuses earlier search work; bypass and refresh compute fresh results and are honored only for accounts with private-data access.

Allowed values:

freshnessenumOptional

auto refreshes date-sensitive queries before cache admission; cached permits ordinary cache reuse. Explicit admitted bypass or refresh wins.

Allowed values:

modestringOptional

Search strategy to run. Defaults to auto: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: exact and keyword skip planner model resolution and its rate limit. Entity and person natural-search take every value but hybrid; news and federated search accept only auto and keyword; content search accepts auto, keyword, semantic, and hybrid (semantic and hybrid only for one entity’s or person’s content).

modelstring or nullOptional

Optional supported model id for planning the search. Leave the field out for the server’s model; a value that is not a supported model id answers 422.

modelCatalogRevisioninteger or nullOptional

Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.

reasoningEffortstring or nullOptional

Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at medium; higher values are lowered.

searchCatalogRevisioninteger or nullOptional

Search catalog revision this search uses for its global search policy and vocabulary; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.

tenantPolicyRevisioninteger or nullOptional

Runtime policy revision this search uses for the serving deployment’s execution budgets; null reads that deployment’s current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.

Response headers

X-RateLimit-LimitintegerOptional

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

X-RateLimit-RemainingintegerOptional

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

X-RateLimit-ResetintegerOptional

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

Response

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

406

Not Acceptable Error

409

Conflict Error

415

Unsupported Media Type Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error