List Content

GET

https://api.aventure.vc/v1/content

GET

/v1/content

curl https://api.aventure.vc/v1/content \
     -H "Authorization: Bearer <token>"

{
  "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
}

Returns news articles, blog posts, repositories, websites, and pages related to one company (ownerEntityId) or person (ownerPersonId); omit both owners to page 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

topicstringOptional

Topic key or source category.

contentTypeenumOptional

Public content type filter.

relationenumOptional

How the content relates to the entity or person.

Allowed values:

yearintegerOptional

Best-effort content year filter.

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.

existenceProbebooleanOptionalDefaults to false

Set true on a first-page request when you only need to know whether any content exists; the response then skips the exact total and stable ordering.

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

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error