List content

GET

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

GET

/v1/content

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

1 {
2   "content": [
3     {
4       "contentId": "string",
5       "contentType": "newsArticle",
6       "title": "string",
7       "canonicalUrl": "string",
8       "createdAt": "2024-01-15T09:30:00Z",
9       "publishedAt": "2024-01-15T09:30:00Z",
10       "relation": "by",
11       "sourceDomain": "string",
12       "sourceName": "string",
13       "summary": "string",
14       "topic": "string",
15       "updatedAt": "2024-01-15T09:30:00Z",
16       "url": "string",
17       "year": 1
18     }
19   ],
20   "empty": true,
21   "first": true,
22   "last": true,
23   "number": 1,
24   "numberOfElements": 1,
25   "pageable": {
26     "offset": 1,
27     "pageNumber": 1,
28     "pageSize": 1,
29     "paged": true,
30     "sort": {
31       "empty": true,
32       "sorted": true,
33       "unsorted": true
34     },
35     "unpaged": true
36   },
37   "size": 1,
38   "sort": {
39     "empty": true,
40     "sorted": true,
41     "unsorted": true
42   },
43   "totalElements": 1,
44   "totalPages": 1
45 }

Returns a paged public content index across supported source owners.

Authentication

AuthorizationBearer

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

X-API-Keystring

Admin API key for system-to-system write operations

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Query parameters

topicstringOptional

Topic key or source category.

contentTypeenumOptional

Public content type filter.

relationenumOptional

Owner relation filter.

Allowed values:

yearintegerOptional

Best-effort content year filter.

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 for first-page content-existence probes that do not need exact totals or stable ordering.

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

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error