Skip to content

just the news please

Notifications You must be signed in to change notification settings

usertermed/justthenews

Folders and files

NameName
Last commit message
Last commit date

Latest commit

98417e2 · · Dec 23, 2025

History

43 Commits
Dec 23, 2025
Dec 23, 2025
Dec 22, 2025
Dec 22, 2025
Dec 22, 2025
Dec 23, 2025
Dec 20, 2025
Dec 20, 2025
Dec 22, 2025
Dec 22, 2025
Dec 20, 2025
Dec 20, 2025
Dec 20, 2025

Repository files navigation

just the news, please

screenshot of web /1 screenshot of web /2 screenshot of web /3

API status GitHub last commit GitHub / Vercel build passing

simple headline-based news website for gathering quick information

ad free, overstimulation-free, forever

API docs

jtn has a small RESTful api (/api/v1/).

v1 Endpoints

GET /api/v1/get/headline

Returns a random headline from the top stories. Response: JSON object containing article details.

GET /api/v1/get/categories

Returns a list of valid news categories. Response: {"categories": ["business", "entertainment", ...]}

GET /api/v1/get/headline/[category]

Returns a random headline from a specific category. Example: /api/v1/get/headline/technology Response: JSON object containing article details (or 404 if empty).

GET /api/v1/search?q=[query]

Returns a random headline matching the search query. Example: /api/v1/search?q=bitcoin Response: JSON object containing article details (or 404 if no match).

GET /api/v1/status

Returns API health status. Response: {"status": "ok", "uptime": 123.45, ...}

Releases

No releases published

Packages

No packages published