NewsBlur

NewsBlur is a personal news reader that brings people together to talk about the world. It is an RSS/Atom feed aggregator with training-based intelligence (hide or highlight stories per feed), original-site and original-text views, saved (starred) stories, folders, OPML import/export, and a social layer of shareable "blurblogs" with following, comments and likes. NewsBlur is open source (MIT, github.com/samuelclay/NewsBlur), runs native iOS, macOS and Android apps, and exposes a documented HTTP API plus an official hosted Model Context Protocol (MCP) server at newsblur.com/mcp for AI agents. This profile captures NewsBlur's public API surface for the API Evangelist network.

NewsBlur publishes 7 APIs on the APIs.io network, including authentication API, classifiers API, feed-management API, and 4 more. Tagged areas include Company, RSS, News, Feed Reader, and Aggregator.

NewsBlur’s developer surface includes documentation, API reference, support, engineering blog, signup flow, authentication, and 16 more developer resources.

41.8/100 thin ▬ flat Agent 55/100 agent ready Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
7 APIs 1 MCP Servers
CompanyRSSNewsFeed ReaderAggregatorSocialContentMediaOpen SourceMCP

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 41.8/100 · thin
Contract Quality 13.0 / 25
Developer Ergonomics 11.3 / 20
Commercial Clarity 6.8 / 20
Operational Transparency 0.7 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 55/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/newsblur: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

NewsBlur authentication API

Login, logout and signup.

NewsBlur classifiers API

Intelligence training classifiers.

NewsBlur feed-management API

Subscriptions, folders and organization.

NewsBlur feeds API

Feed subscription, search and metadata.

NewsBlur import-export API

OPML import and export.

NewsBlur social API

Blurblogs, sharing, following and comments.

NewsBlur stories API

Reading, marking and starring stories.

Scroll for all 7

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

newsblur-mcp.yml

MCP SERVER

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Newsblur Authentication

apiKey/http · 2 schemes

SECURITY

Newsblur Domain Security

TLSv1.3 · HSTS

SECURITY

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: newsblur
name: NewsBlur
description: NewsBlur is a personal news reader that brings people together to talk about the world. It is an RSS/Atom feed
  aggregator with training-based intelligence (hide or highlight stories per feed), original-site and original-text views,
  saved (starred) stories, folders, OPML import/export, and a social layer of shareable "blurblogs" with following, comments
  and likes. NewsBlur is open source (MIT, github.com/samuelclay/NewsBlur), runs native iOS, macOS and Android apps, and exposes
  a documented HTTP API plus an official hosted Model Context Protocol (MCP) server at newsblur.com/mcp for AI agents. This
  profile captures NewsBlur's public API surface for the API Evangelist network.
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://www.newsblur.com/media/img/logo_512.png
url: https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- a16z
- y-combinator
x-tier: stub
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-20'
tags:
- Company
- RSS
- News
- Feed Reader
- Aggregator
- Social
- Content
- Media
- Open Source
- MCP
apis:
- aid: newsblur:newsblur-authentication-api
  name: NewsBlur authentication API
  description: Login, logout and signup.
  humanURL: https://www.newsblur.com/api
  baseURL: https://www.newsblur.com
  tags:
  - authentication
  properties:
  - type: OpenAPI
    url: openapi/newsblur-authentication-api-openapi.yml
  - type: Authentication
    url: authentication/newsblur-authentication.yml
  - type: Conventions
    url: conventions/newsblur-conventions.yml
  - type: ErrorCatalog
    url: errors/newsblur-problem-types.yml
  - type: DataModel
    url: data-model/newsblur-data-model.yml
  - type: Conformance
    url: conformance/newsblur-conformance.yml
- aid: newsblur:newsblur-classifiers-api
  name: NewsBlur classifiers API
  description: Intelligence training classifiers.
  humanURL: https://www.newsblur.com/api
  baseURL: https://www.newsblur.com
  tags:
  - classifiers
  properties:
  - type: OpenAPI
    url: openapi/newsblur-classifiers-api-openapi.yml
  - type: Authentication
    url: authentication/newsblur-authentication.yml
  - type: Conventions
    url: conventions/newsblur-conventions.yml
  - type: ErrorCatalog
    url: errors/newsblur-problem-types.yml
  - type: DataModel
    url: data-model/newsblur-data-model.yml
  - type: Conformance
    url: conformance/newsblur-conformance.yml
- aid: newsblur:newsblur-feed-management-api
  name: NewsBlur feed-management API
  description: Subscriptions, folders and organization.
  humanURL: https://www.newsblur.com/api
  baseURL: https://www.newsblur.com
  tags:
  - feed-management
  properties:
  - type: OpenAPI
    url: openapi/newsblur-feed-management-api-openapi.yml
  - type: Authentication
    url: authentication/newsblur-authentication.yml
  - type: Conventions
    url: conventions/newsblur-conventions.yml
  - type: ErrorCatalog
    url: errors/newsblur-problem-types.yml
  - type: DataModel
    url: data-model/newsblur-data-model.yml
  - type: Conformance
    url: conformance/newsblur-conformance.yml
- aid: newsblur:newsblur-feeds-api
  name: NewsBlur feeds API
  description: Feed subscription, search and metadata.
  humanURL: https://www.newsblur.com/api
  baseURL: https://www.newsblur.com
  tags:
  - feeds
  properties:
  - type: OpenAPI
    url: openapi/newsblur-feeds-api-openapi.yml
  - type: Authentication
    url: authentication/newsblur-authentication.yml
  - type: Conventions
    url: conventions/newsblur-conventions.yml
  - type: ErrorCatalog
    url: errors/newsblur-problem-types.yml
  - type: DataModel
    url: data-model/newsblur-data-model.yml
  - type: Conformance
    url: conformance/newsblur-conformance.yml
- aid: newsblur:newsblur-import-export-api
  name: NewsBlur import-export API
  description: OPML import and export.
  humanURL: https://www.newsblur.com/api
  baseURL: https://www.newsblur.com
  tags:
  - import-export
  properties:
  - type: OpenAPI
    url: openapi/newsblur-import-export-api-openapi.yml
  - type: Authentication
    url: authentication/newsblur-authentication.yml
  - type: Conventions
    url: conventions/newsblur-conventions.yml
  - type: ErrorCatalog
    url: errors/newsblur-problem-types.yml
  - type: DataModel
    url: data-model/newsblur-data-model.yml
  - type: Conformance
    url: conformance/newsblur-conformance.yml
- aid: newsblur:newsblur-social-api
  name: NewsBlur social API
  description: Blurblogs, sharing, following and comments.
  humanURL: https://www.newsblur.com/api
  baseURL: https://www.newsblur.com
  tags:
  - social
  properties:
  - type: OpenAPI
    url: openapi/newsblur-social-api-openapi.yml
  - type: Authentication
    url: authentication/newsblur-authentication.yml
  - type: Conventions
    url: conventions/newsblur-conventions.yml
  - type: ErrorCatalog
    url: errors/newsblur-problem-types.yml
  - type: DataModel
    url: data-model/newsblur-data-model.yml
  - type: Conformance
    url: conformance/newsblur-conformance.yml
- aid: newsblur:newsblur-stories-api
  name: NewsBlur stories API
  description: Reading, marking and starring stories.
  humanURL: https://www.newsblur.com/api
  baseURL: https://www.newsblur.com
  tags:
  - stories
  properties:
  - type: OpenAPI
    url: openapi/newsblur-stories-api-openapi.yml
  - type: Authentication
    url: authentication/newsblur-authentication.yml
  - type: Conventions
    url: conventions/newsblur-conventions.yml
  - type: ErrorCatalog
    url: errors/newsblur-problem-types.yml
  - type: DataModel
    url: data-model/newsblur-data-model.yml
  - type: Conformance
    url: conformance/newsblur-conformance.yml
common:
- type: DeveloperPortal
  url: https://www.newsblur.com/api
- type: Documentation
  url: https://www.newsblur.com/api
- type: APIReference
  url: https://www.newsblur.com/api
- type: GitHubOrganization
  url: https://github.com/samuelclay/NewsBlur
- type: Support
  url: https://forum.newsblur.com
- type: Blog
  url: https://blog.newsblur.com
- type: PrivacyPolicy
  url: https://www.newsblur.com/privacy
- type: TermsOfService
  url: https://www.newsblur.com/tos
- type: SignUp
  url: https://www.newsblur.com/
- type: MCPServer
  url: mcp/newsblur-mcp.yml
- type: Authentication
  url: authentication/newsblur-authentication.yml
- type: Conventions
  url: conventions/newsblur-conventions.yml
- type: Packages
  url: packages/newsblur-packages.yml
- type: LLMsTxt
  url: llms/newsblur-llms.txt
- type: WellKnown
  url: well-known/newsblur-well-known.yml
- type: Lifecycle
  url: lifecycle/newsblur-lifecycle.yml
- type: DomainSecurity
  url: security/newsblur-domain-security.yml
- type: DataModel
  url: data-model/newsblur-data-model.yml
- type: ErrorCatalog
  url: errors/newsblur-problem-types.yml
- type: Conformance
  url: conformance/newsblur-conformance.yml
- type: Overlay
  url: overlays/newsblur-openapi-overlay.yaml
- type: AgentSkill
  url: skills/_index.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
x-enrichment:
  date: '2026-07-20'
  status: enriched
  artifacts_added: 17
  pass: local-v1