An Objective-C wrapper around (unofficial) Google Reader API for iOS Apps.
Objective-C C Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Attention please

I'm not commiting any more on this project. It all started as a game of a one bored night. It's buggy and misses Unit Tests. If you'd want to mantain it, please do a Fork, fixes the issues and I'd be very glad to merge it back as the master.

GoogleReaderAPI - iOS client

An Objective-C wrapper around (unofficial) Google Reader API for iOS Apps.

This is an Objective-C wrapper around unofficial GoogleReader API. I'm open sourcing this library while working on a side project.

DISCLAIMER: Google has no official API for Google Reader. This library has been inspired by the Pyrfeed project (a python client). All endpoints and api methods have been discovered through reverse engineering. There is NO official documentation neither warranty. This is a work in progress.


  • All requests are now Async
  • Written all API methods (still need to add OC Unit Test)
  • Written a GoogleReaderRequestDelegate Protocol
  • Refactored all methods (bringed all methods from class methods to instance methods)
  • Added JSON parsing with SBJSON library


  • Authentication via ClientLogin
  • Asynchronous requests
  • High level API methods
  • JSON responses encoded in NSDictionary


  • Test case
  • Async all requests/responses
  • High-level API methods
  • Encoding of JSON responses into native NSDictionary
  • oAuth v2.0 method support (when it will be available)
  • Unofficial documentation

Mini tutorial: use in your project

Warning: make this at your own risk. I remember you this is a very ALPHA stage.

  • Include "GoogleReader.h" "GoogleReader.m" and "Constants.h" in your XCode Project.

  • Instantiate a new GoogleReader object and set its delegate (remember to implement protocol methods in your delegate):

    GoogleReader *reader = [GoogleReader alloc] init]; [reader setDelegate:self];

  • Check if user needs authentication

    [reader isNeedAuth];

  • API request example: Get all Reader subscriptions

    [reader getSubscriptionsList];

  • API requext example: Add a new subscription

    [reader addSubscriptionWithURL:(NSString *)url feed:(NSString *)feed labels:(NSArray *)labels];

Any help is welcome.


Copyright 2011 Simone Carella/Aaron Brethorst.