Developer API & RSS

Public RSS feeds and the read-only JSON Partner API · v1

Unbiased Headlines publishes original, cross-spectrum news briefings. We offer two public ways to syndicate our published headlines: standard RSS feeds and a simple read-only JSON Partner API. Base URL for everything below is https://unbiasedheadlines.com.

At a glance (v1)

• Public & read-only — published content only. No auth/API key required for pilot use. No writes, no user or private data.
• Rate-limited — requests are throttled per client; please cache responses.
• Cached — responses send Cache-Control: public headers (300–600s). Respect them; CDNs and clients may serve cached copies.
• Attribution required — see the Attribution section below.

RSS Feeds

Standard RSS 2.0, newest 50 articles, fully dynamic:

• GET /rss  (alias: /feed.xml)
• Category filter: /rss?categories=politics,tech

Allowed categories: politics, tech, defense, economy, finance, energy, health.

curl "https://unbiasedheadlines.com/rss?categories=tech,defense"

JSON Partner API (v1)

GET /api/public/v1/articles

List and search published articles. Returns metadata cards (no article body).

Param	Notes
limit	1–50 (default 20, capped at 50)
offset	pagination offset
category	one of the allowed categories above (others ignored)
q	keyword search, accent-insensitive, max 200 chars; relevance-ranked

curl "https://unbiasedheadlines.com/api/public/v1/articles?limit=10&category=tech"
curl "https://unbiasedheadlines.com/api/public/v1/articles?q=election"

{
  "attribution": {
    "provider": "Unbiased Headlines",
    "source": "unbiasedheadlines.com",
    "url": "https://unbiasedheadlines.com",
    "tagline": "Facts. Not Spin.",
    "license": "Attribution required — link back to unbiasedheadlines.com"
  },
  "articles": [
    {
      "id": "7039",
      "slug": "example-article-slug",
      "title": "Example Headline",
      "summary": "Short neutral summary…",
      "category": "politics",
      "published_at": "2026-06-28T18:00:00.000Z",
      "updated_at": null,
      "url": "https://unbiasedheadlines.com/article/example-article-slug",
      "canonical_url": "https://unbiasedheadlines.com/article/example-article-slug",
      "image": "https://unbiasedheadlines.com/images/articles/example.jpg",
      "source_count": 4,
      "bias_score": 0.1,
      "is_breaking": false,
      "has_audio": true
    }
  ],
  "total": 1126,
  "limit": 10,
  "offset": 0
}

GET /api/public/v1/articles/:slug

Fetch one article including the full body, normalized cross-spectrum sources, and update changelog.

curl "https://unbiasedheadlines.com/api/public/v1/articles/example-article-slug"

{
  "attribution": { "provider": "Unbiased Headlines", "...": "..." },
  "article": {
    "slug": "example-article-slug",
    "title": "Example Headline",
    "summary": "Short neutral summary…",
    "body": "Full briefing text…",
    "canonical_url": "https://unbiasedheadlines.com/article/example-article-slug",
    "sources": [
      { "name": "Reuters", "url": "https://…", "lean": 0, "title": "Original report title" }
    ],
    "changelog": []
  }
}

GET /api/public/v1/categories

List published categories with article counts.

curl "https://unbiasedheadlines.com/api/public/v1/categories"

{
  "attribution": { "provider": "Unbiased Headlines", "...": "..." },
  "categories": [ { "slug": "tech", "count": 1128 }, { "slug": "politics", "count": 1126 } ]
}

Attribution & Usage

Every API response includes a top-level attribution object, and every article includes a canonical_url. When you display or syndicate our content, you must:

• Cite Unbiased Headlines as the source.
• Link back using the canonical https://unbiasedheadlines.com URL provided in each item (canonical_url).
• Not imply endorsement, and not modify summaries in a way that misrepresents the original briefing.

v1 is a public pilot. Heavier or commercial integrations, per-partner quotas, and API keys may be offered later. For partnership questions, reach us via unbiasedheadlines.com. See also our Terms.