News monitoring · API reference

Query parameters

company_iduuidoptional
Company UUID (optional; otherwise the organisation's recent news).
limitintegeroptional
Maximum number of news items (default 20).

Response

Status 200, application/json. Resources outside your rights are absent, never an error.

newsobject[]
Show child attributes
- datestring · nullable
- titlestring · nullable
- classificationstring · nullable
- impact_scorenumber · nullable
- sourcestring · nullable
- urlstring · nullable
synthesisstring · nullable

Errors

400 invalid parameter · 401 missing or expired token · 429 too many requests · 500 read failed. See Errors.

Request

cURL

curl "https://jolv-mcp.vercel.app/v1/get_veille" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

r = requests.get(
    "https://jolv-mcp.vercel.app/v1/get_veille",
    headers={"Authorization": f"Bearer {os.environ['JOLV_TOKEN']}"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

JavaScript

const r = await fetch("https://jolv-mcp.vercel.app/v1/get_veille", {
  headers: { Authorization: `Bearer ${process.env.JOLV_TOKEN}` },
});
if (!r.ok) throw new Error((await r.json()).error.message);
const data = await r.json();

Power Query

let
    Source = Json.Document(Web.Contents(
        "https://jolv-mcp.vercel.app/v1/get_veille",
        [Headers = [Authorization = "Bearer <access_token>"]]))
in
    Source

Example response (illustrative values)

200

{
  "news": [
    {
      "date": "2026-02-09",
      "title": "Nordlicht Software signs a three-year contract with a DAX-listed retailer",
      "classification": "commercial",
      "impact_score": 0.72,
      "source": "Handelsblatt",
      "url": "https://www.handelsblatt.example/nordlicht-contract"
    },
    {
      "date": "2026-01-27",
      "title": "Nordlicht Software opens a Vienna office",
      "classification": "expansion",
      "impact_score": 0.41,
      "source": "Company press release",
      "url": "https://www.nordlicht.example/press/vienna"
    }
  ],
  "synthesis": "Commercial momentum is positive: one large contract signed and a new office opened. No adverse news in the period."
}

Try it

or paste a token below

The call goes from your browser to the API with your own token; nothing is stored. Token kept in this tab only.