Skip to content
Nyuchi Docs

News API

The news namespace exposes the Mukoko news read surface—articles, journalists, and media organisations—plus a small write surface for engagement actions (like, bookmark, comment, follow). It is backed by the mukoko_news_db Supabase project.

Articles and metadata are scored and curated upstream. The router serves the curated read surface to consumer apps and accepts engagement events from authenticated readers.

Base path: /v1/news

Endpoints

Section titled “Endpoints”
Method Path Auth Purpose
GET /v1/news/articles Optional List articles. Supports organization_id, journalist_id, limit, offset.
GET /v1/news/articles/{article_id} Optional Fetch a single article.
GET /v1/news/organizations Optional List media organisations.
GET /v1/news/journalists Optional List journalists. Supports organization_id.
POST /v1/news/articles/{article_id}/like Required Like an article (idempotent upsert).
POST /v1/news/articles/{article_id}/bookmark Required Bookmark an article (idempotent upsert).
POST /v1/news/comments Required Post a comment on an article. Supports threaded replies via parent_id.
POST /v1/news/journalists/{journalist_id}/follow Required Follow a journalist.
POST /v1/news/organizations/{organization_id}/follow Required Follow a media organisation.

List recent articles

Section titled “List recent articles”

Articles are ordered by published_at descending.

Terminal window
curl "https://api.nyuchi.com/v1/news/articles?limit=10"

Like an article

Section titled “Like an article”

Like, bookmark, and follow endpoints are idempotent—calling them twice is safe. The caller’s identity is recorded automatically.

Terminal window
curl -X POST https://api.nyuchi.com/v1/news/articles/art_01/like \
  -H "Authorization: Bearer $TOKEN"

Post a comment

Section titled “Post a comment”
Terminal window
curl -X POST https://api.nyuchi.com/v1/news/comments \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "article_id": "art_01",
    "text": "Great reporting on this story.",
    "parent_id": null
  }'

Set parent_id to a comment ID to post a threaded reply.