Get news article by ID

GET

https://api.aventure.vc/v1/news/:newsId

GET

/v1/news/:newsId

$ curl https://api.aventure.vc/v1/news/1 \
>      -H "X-Client-Secret: <apiKey>"

1 {
2   "core": {
3     "id": 1,
4     "title": "string",
5     "author": "string",
6     "category": "string",
7     "createdAt": "2024-01-15T09:30:00Z",
8     "excerpt": "string",
9     "externalNewsArticle": true,
10     "newsImageThumbnail": "string",
11     "newsUrlOriginal": "string",
12     "pendingApproval": 1,
13     "publication": "string",
14     "publishedAt": "2024-01-15T09:30:00Z",
15     "slug": "aventure-vc",
16     "updatedAt": "2024-01-15T09:30:00Z"
17   },
18   "entityMentionResolved": [
19     {
20       "createdAt": "2024-01-15T09:30:00Z",
21       "entityId": "string",
22       "internal": true,
23       "updatedAt": "2024-01-15T09:30:00Z",
24       "href": "string",
25       "matchScore": 1.1,
26       "matchType": "string",
27       "mention": "string",
28       "slug": "aventure-vc",
29       "typeRecord": "Company"
30     }
31   ],
32   "personMentionResolved": [
33     {
34       "createdAt": "2024-01-15T09:30:00Z",
35       "personId": "string",
36       "updatedAt": "2024-01-15T09:30:00Z",
37       "href": "string",
38       "matchScore": 1.1,
39       "matchType": "string",
40       "mention": "string",
41       "slug": "aventure-vc"
42     }
43   ],
44   "content": "string",
45   "externalId": "string",
46   "linkedContent": "string"
47 }

Returns news detail by exact positive ID. Use lookup for a slug, external ID, URL, or title candidates.

Authentication

X-Client-Secretstring

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

Path parameters

newsIdintegerRequired

Exact positive news article id.

Response

News detail as canonical JSON or compact text.

coreobject

Canonical news owner for list and core semantics

entityMentionResolvedlist of objects

Resolved entity mentions — read-only display projections. News mutations attach entities only via flat entityJoinId values, never these nested objects.

personMentionResolvedlist of objects

Resolved person mentions — read-only display projections. News mutations attach people only via flat personId/personSlug values, never these nested objects.

contentstring or nullOptional

externalIdstring or nullOptional

linkedContentstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error