# API Reference for Agents ## Server Salt (for signed endpoints) serverSalt = "8a8e2fb1304a4c72ff52500b721991b0492fcdf15e1fda0d1d14b52525b2609e" Sign any `url` parameter with: hex(sha256(url + serverSalt)) ## GET / Query params: - sources: comma-separated source slugs (e.g. svd,dn) - keywords: comma-separated OR groups, plus-separated AND terms (e.g. ai,gpt,jensen+huang) - since: duration like 10m, 1h, 3h, 12h, 1d - format: html (default), json, rss, markdown - fontSize: integer pixel size - extraSpacing: integer line spacing - limit: max results (default 100, max 200) - before: unix timestamp for pagination - ids: comma-separated URL hashes for specific articles ## GET /api/headlines Paginated JSON API. Same filtering params as `/`. Additional params: - before: unix timestamp; fetch headlines older than this - limit: page size (default 100, max 200) Response: { "headlines": [...], "has_more": bool, "next_before": unix_timestamp, "total": int } ## GET /summary/:window HTML summaries. Windows: 1h, 3h, 12h, 24h. ## GET /article-data Requires: url, sign (computed with serverSalt above) Returns: { title, title_en, description, description_en } ## GET /story-keywords Requires: url, sign (computed with serverSalt above) Returns: { article_ids: [...], count: int, fallback: bool }