How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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.2.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.2.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
Where this information came from

This is an independent, third-party profile of NewsBlur stories API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.