FreshRSS - Google Reader compatible API implementation

See Mobile access for general aspects of API access. Additionally page about our Fever compatible API for another possibility.

RSS clients

There are many RSS clients that support the Fever API, but they might understand the API a bit differently. If your favourite client doesn’t work properly with this API, please create an issue and we’ll have a look. But we can only do that for free clients.

Usage & Authentication

Before you can start using this API, you have to enable and setup API access, which is documented here, and then reset the user’s API password.

Then point your mobile application to the greader.php address (e.g. https://freshrss.example.net/api/greader.php).

Compatible clients

  1. On the same FreshRSS API page, note the address given under “Your API address”, like https://freshrss.example.net/api/greader.php
  2. Type the API address in a client, together with your FreshRSS username, and the corresponding special API password.
App Platform License
News+ with News+ Google Reader extension Android Closed Source (Free)
FeedMe 3.5.3+ Android Closed Source (Free)
EasyRSS Android GPLv3 (F-Droid)
Readrops Android GPLv3
FocusReader Android Closed Source(Free)
FeedReader 2.0+ Linux GPLv3
Newsboat 2.24+ Linux MIT
Vienna RSS macOS Apache-2.0
Reeder macOS, iOS Closed Source
FreshRSS-Notify Firefox Open Source

Google Reader compatible API

Examples of basic queries:

# Initial login, using API password (Email and Passwd can be given either as GET, or POST - better)
curl 'https://freshrss.example.net/api/greader.php/accounts/ClientLogin?Email=alice&Passwd=Abcdef123456'
SID=alice/8e6845e089457af25303abc6f53356eb60bdb5f8
Auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8

# Examples of read-only requests
curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/subscription/list?output=json'

curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/unread-count?output=json'

curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/tag/list?output=json'

# Retrieve a token for requests making modifications
curl -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/token'
8e6845e089457af25303abc6f53356eb60bdb5f8ZZZZZZZZZZZZZZZZZ

# Get articles, piped to jq for easier JSON reading
curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/stream/contents/reading-list' | jq .