Get One News Article

GET

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

GET

/v1/news/:newsId

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

{
  "core": {
    "id": 1,
    "title": "string",
    "author": "string",
    "category": "string",
    "createdAt": "2024-01-15T09:30:00Z",
    "excerpt": "string",
    "externalNewsArticle": true,
    "newsImageThumbnail": "string",
    "newsUrlOriginal": "string",
    "publication": "string",
    "publishedAt": "2024-01-15T09:30:00Z",
    "slug": "aventure-vc",
    "titleMention": [
      {
        "end": 1,
        "start": 1,
        "entity": {
          "createdAt": "2024-01-15T09:30:00Z",
          "entityId": "string",
          "internal": true,
          "updatedAt": "2024-01-15T09:30:00Z",
          "href": "string",
          "matchStatus": "auto-match",
          "mention": "string",
          "slug": "aventure-vc",
          "typeRecord": "Company"
        },
        "person": {
          "createdAt": "2024-01-15T09:30:00Z",
          "personId": "string",
          "updatedAt": "2024-01-15T09:30:00Z",
          "href": "string",
          "matchStatus": "auto-match",
          "mention": "string",
          "slug": "aventure-vc"
        }
      }
    ],
    "updatedAt": "2024-01-15T09:30:00Z"
  },
  "entityMentionResolved": [
    {
      "createdAt": "2024-01-15T09:30:00Z",
      "entityId": "string",
      "internal": true,
      "updatedAt": "2024-01-15T09:30:00Z",
      "href": "string",
      "matchStatus": "auto-match",
      "mention": "string",
      "slug": "aventure-vc",
      "typeRecord": "Company"
    }
  ],
  "personMentionResolved": [
    {
      "createdAt": "2024-01-15T09:30:00Z",
      "personId": "string",
      "updatedAt": "2024-01-15T09:30:00Z",
      "href": "string",
      "matchStatus": "auto-match",
      "mention": "string",
      "slug": "aventure-vc"
    }
  ],
  "analysis": {
    "newsId": 1,
    "publishedAt": "2024-01-15T09:30:00Z",
    "section": [
      {
        "reference": [
          {
            "quote": "string",
            "url": "string",
            "sourceDocumentId": "string"
          }
        ],
        "stepKey": "string",
        "text": "string",
        "title": "string"
      }
    ],
    "version": 1
  },
  "content": "string",
  "externalId": "string",
  "linkedContent": "string",
  "linkerCompleted": true
}

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

Authentication

AuthorizationBearer

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

Path parameters

newsIdintegerRequired

Exact positive news article id.

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

News detail as canonical JSON or compact text.

coreobject

A news article, as returned by news lists and the entity.news.published webhook.

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.

analysisobject or nullOptional

Current shared article analysis, absent before publication.

contentstring or nullOptional

externalIdstring or nullOptional

linkedContentstring or nullOptional

linkerCompletedbooleanOptional

Whether the entity linker completed, including an empty result.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error