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 social API

Blurblogs, sharing, following and comments.

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

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

This API exposes 19 operations across 19 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.

19 operations 19 paths 0 schemas 8 GET11 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 social 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 19

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

social 19

Blurblogs, sharing, following and comments.

GET
/social/river_stories
Stories from followed users
getSocialRiverStories → 200
POST
/social/share_story
Share a story with optional comment
shareStory → 200
POST
/social/unshare_story
Remove a shared story
unshareStory → 200
GET
/social/load_user_friends
Followers and following profiles
loadUserFriends → 200
GET
/social/profile
A user's public profile
getSocialProfile → 200
GET
/social/load_user_profile
The current user's private profile details
loadUserProfile → 200
POST
/social/save_user_profile
Update profile information
saveUserProfile → 200
GET
/social/interactions
User interactions
getInteractions → 200
GET
/social/activities
User activity feed
getActivities → 200
POST
/social/follow
Follow a user's blurblog
followUser → 200
POST
/social/unfollow
Unfollow a user
unfollowUser → 200
POST
/social/mute_user
Mute a user's content
muteUser → 200
POST
/social/unmute_user
Restore a muted user's visibility
unmuteUser → 200
GET
/social/public_comments
Public comments on a story
getPublicComments → 200
POST
/social/save_comment_reply
Add a reply to a comment
saveCommentReply → 200
POST
/social/remove_comment_reply
Delete a comment reply
removeCommentReply → 200
POST
/social/like_comment
Favorite a comment
likeComment → 200
POST
/social/remove_like_comment
Unfavorite a comment
removeLikeComment → 200
GET
/social/find_friends
Search for users
findFriends → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

newsblur-social-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 stories API