News for your product, checked before it ships.

NR=https://api.tlsnewsroom.com/v1/newsrooms/nr_markets

# Ask your newsroom for a story
curl -X POST $NR/generations \
  -H "Authorization: Bearer $NEWSROOM_API_KEY" \
  -H "Idempotency-Key: fed-decision-0917" \
  -H "Content-Type: application/json" \
  -d '{ "output_format": "ticker_card" }'

# Then read the stories that passed
curl $NR/articles \
  -H "Authorization: Bearer $NEWSROOM_API_KEY"

const api = "https://api.tlsnewsroom.com/v1/newsrooms/nr_markets";
const headers = {
  Authorization: `Bearer ${process.env.NEWSROOM_API_KEY}`,
  "Content-Type": "application/json",
};

// Ask for a story. Retries with the same key never double-bill.
await fetch(`${api}/generations`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": "fed-decision-0917" },
  body: JSON.stringify({ output_format: "ticker_card" }),
});

// Read the stories that passed the check.
const { data } = await (await fetch(`${api}/articles`, { headers })).json();
for (const story of data) console.log(story.title, story.source_urls);

import os, requests

api = "https://api.tlsnewsroom.com/v1/newsrooms/nr_markets"
headers = {"Authorization": f"Bearer {os.environ['NEWSROOM_API_KEY']}"}

# Ask for a story. Retries with the same key never double-bill.
requests.post(
    f"{api}/generations",
    headers={**headers, "Idempotency-Key": "fed-decision-0917"},
    json={"output_format": "ticker_card"},
)

# Read the stories that passed the check.
for story in requests.get(f"{api}/articles", headers=headers).json()["data"]:
    print(story["title"], story["source_urls"])

import crypto from "node:crypto";

// Newsroom-Signature: t=<unix time>,v1=<hex HMAC-SHA256 of "t.body">
export function verify(rawBody, header, secret) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${t}.${rawBody}`)
    .digest("hex");
  return crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected));
}

// event.type is "article.ready", "generation.blocked",
// "article.retracted", or "generation.failed".