Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

NewsBlur stories API

Reading, marking and starring stories.

NewsBlur stories API is one of 7 APIs that NewsBlur publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include stories. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 14 operations across 14 paths. It is described by OpenAPI 3.1.0, at version 2026.07.

Requests are made against a single base URL, https://www.newsblur.com.

14 operations 14 paths 0 schemas 8 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2026.07
Base URL
https://www.newsblur.com
Authentication
API Key, HTTP Bearer
Contact
License
Resource Areas
1

Authentication & Security 2

NewsBlur stories API declares 2 security schemes for authenticating requests. An API key is passed in the cookie as newsblur_sessionid (cookieAuth). It accepts HTTP bearer tokens (oauth2Bearer). By default, every request must be authenticated.

  • cookieAuth — Session cookie set by POST /api/login.
  • oauth2Bearer — OAuth 2.0 access token passed as a Bearer token in the Authorization header. Client credentials are issued by NewsBlur (contact samuel@newsblur.com).

Paths & Operations 14

Across 14 paths, the API surfaces 14 operations — 8 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

stories 14

Reading, marking and starring stories.

GET
/reader/feed/{id}
Stories from a single feed
getFeedStories 2 params → 200404
GET
/reader/river_stories
Stories across multiple feeds (the "river")
getRiverStories 2 params → 200
GET
/reader/starred_stories
The user's saved (starred) stories
getStarredStories → 200
GET
/reader/starred_story_hashes
Identifiers of saved stories
getStarredStoryHashes → 200
GET
/reader/unread_story_hashes
Identifiers of unread stories
getUnreadStoryHashes → 200
GET
/reader/read_stories
Previously read stories
getReadStories → 200
GET
/rss_feeds/original_text
Extracted original story text
getOriginalText 1 param → 200
GET
/rss_feeds/original_story
Original website content for a story
getOriginalStory 1 param → 200
POST
/reader/mark_story_hashes_as_read
Mark multiple stories as read
markStoryHashesAsRead → 200
POST
/reader/mark_story_hash_as_unread
Mark a story as unread
markStoryHashAsUnread → 200
POST
/reader/mark_story_hash_as_starred
Save (star) a story
markStoryHashAsStarred → 200
POST
/reader/mark_story_hash_as_unstarred
Unsave (unstar) a story
markStoryHashAsUnstarred → 200
POST
/reader/mark_feed_as_read
Mark an entire feed as read
markFeedAsRead → 200
POST
/reader/mark_all_as_read
Mark everything as read
markAllAsRead → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

newsblur-stories-api-openapi.yml Raw ↑

Other APIs NewsBlur publishes across the network.

NewsBlur authentication API
NewsBlur classifiers API
NewsBlur feed-management API
NewsBlur feeds API
NewsBlur import-export API
NewsBlur social API