NewsBlur

NewsBlur Stories API

Reading, marking and starring stories.

GitHub OpenAPI

Operations 14

GET /reader/feed/{id} Stories from a single feed #
GET /reader/river_stories Stories across multiple feeds (the "river") #
GET /reader/starred_stories The user's saved (starred) stories #
GET /reader/starred_story_hashes Identifiers of saved stories #
GET /reader/unread_story_hashes Identifiers of unread stories #
GET /reader/read_stories Previously read stories #
GET /rss_feeds/original_text Extracted original story text #
GET /rss_feeds/original_story Original website content for a story #
POST /reader/mark_story_hashes_as_read Mark multiple stories as read #
POST /reader/mark_story_hash_as_unread Mark a story as unread #
POST /reader/mark_story_hash_as_starred Save (star) a story #
POST /reader/mark_story_hash_as_unstarred Unsave (unstar) a story #
POST /reader/mark_feed_as_read Mark an entire feed as read #
POST /reader/mark_all_as_read Mark everything as read #

Documentation

📖
Authentication
https://artifacts.apis.io/newsblur/authentication/newsblur-authentication.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/newsblur/openapi/newsblur-stories-api-openapi.yml

Other Resources

🔗
Conventions
https://artifacts.apis.io/newsblur/conventions/newsblur-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/newsblur/errors/newsblur-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/newsblur/data-model/newsblur-data-model.yml
🔗
Conformance
https://artifacts.apis.io/newsblur/conformance/newsblur-conformance.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/newsblur:newsblur-stories-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

newsblur-stories-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: NewsBlur Stories API
  description: NewsBlur is a personal news reader (RSS/Atom aggregator) that brings people together to talk about the world.
  version: '2026.07'
  contact:
    name: NewsBlur
    url: https://www.newsblur.com/api
    email: samuel@newsblur.com
  license:
    name: MIT
    url: https://github.com/samuelclay/NewsBlur/blob/master/LICENSE
  x-source: https://www.newsblur.com/api
servers:
- url: https://www.newsblur.com
  description: Production
security:
- cookieAuth: []
- oauth2Bearer: []
tags:
- name: Stories
  description: Reading, marking and starring stories.
paths:
  /reader/feed/{id}:
    get:
      operationId: getFeedStories
      tags:
      - Stories
      summary: Stories from a single feed
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
      - name: page
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/Ok'
        '404':
          $ref: '#/components/responses/NotFound'
  /reader/river_stories:
    get:
      operationId: getRiverStories
      tags:
      - Stories
      summary: Stories across multiple feeds (the "river")
      parameters:
      - name: feeds
        in: query
        schema:
          type: array
          items:
            type: integer
      - name: page
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/starred_stories:
    get:
      operationId: getStarredStories
      tags:
      - Stories
      summary: The user's saved (starred) stories
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/starred_story_hashes:
    get:
      operationId: getStarredStoryHashes
      tags:
      - Stories
      summary: Identifiers of saved stories
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/unread_story_hashes:
    get:
      operationId: getUnreadStoryHashes
      tags:
      - Stories
      summary: Identifiers of unread stories
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/read_stories:
    get:
      operationId: getReadStories
      tags:
      - Stories
      summary: Previously read stories
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /rss_feeds/original_text:
    get:
      operationId: getOriginalText
      tags:
      - Stories
      summary: Extracted original story text
      parameters:
      - name: story_hash
        in: query
        schema:
          type: string
        required: true
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /rss_feeds/original_story:
    get:
      operationId: getOriginalStory
      tags:
      - Stories
      summary: Original website content for a story
      parameters:
      - name: story_hash
        in: query
        schema:
          type: string
        required: true
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/mark_story_hashes_as_read:
    post:
      operationId: markStoryHashesAsRead
      tags:
      - Stories
      summary: Mark multiple stories as read
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/mark_story_hash_as_unread:
    post:
      operationId: markStoryHashAsUnread
      tags:
      - Stories
      summary: Mark a story as unread
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/mark_story_hash_as_starred:
    post:
      operationId: markStoryHashAsStarred
      tags:
      - Stories
      summary: Save (star) a story
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/mark_story_hash_as_unstarred:
    post:
      operationId: markStoryHashAsUnstarred
      tags:
      - Stories
      summary: Unsave (unstar) a story
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/mark_feed_as_read:
    post:
      operationId: markFeedAsRead
      tags:
      - Stories
      summary: Mark an entire feed as read
      responses:
        '200':
          $ref: '#/components/responses/Ok'
  /reader/mark_all_as_read:
    post:
      operationId: markAllAsRead
      tags:
      - Stories
      summary: Mark everything as read
      responses:
        '200':
          $ref: '#/components/responses/Ok'
components:
  responses:
    NotFound:
      description: Resource not found.
      content:
        application/json:
          schema:
            type: object
    Ok:
      description: Success. NewsBlur returns a JSON object; most responses include a `result` field ("ok" or "error").
      content:
        application/json:
          schema:
            type: object
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: newsblur_sessionid
      description: Session cookie set by POST /api/login.
    oauth2Bearer:
      type: http
      scheme: bearer
      description: OAuth 2.0 access token passed as a Bearer token in the Authorization header. Client credentials are issued by NewsBlur (contact samuel@newsblur.com).