Login | Signup

G2Reader.com API for developers

beta version

The G2Reader API is intended to allow Subscribers to access their RSS items via 3rd Party Clients. As such it provides access to the following data segments:

Overview

Browse each of these sections to get details about how to call the API. If you see items in the platform that you'd like exposed in the API that you don't see above please let us know.

TODOs

  • folder operations
  • account management
  • Concept in general

    All requests are authorized with an access_token. This is generated by the /user/authorize request and requires a client_key.

    You can obtain your client key here.

    All parameters of API calls have to be passed as POST values.

    All dates use the time zone CET. For the presentation to the user is required to shift the date by tz_shift.

    All requests to the G2Reader API are handled via a JSON webservice. All requests are made with the following prefix:

    https://g2reader.com/api/1/

    There are two possible results returned from an G2Reader API call:

    Successful Requests

    {
    	... response data ...
    	"result": "success",
    	"error": null
    }

    Failing Requests

    {
    	"result": "error",
    	"error": "Related Error Message"
    }

    Terms of Use

    1. You must be a registered user to have access to, retrieve and use the G2Reader data.
    2. Do not make an abusive volume of calls against the API.
    3. Respect our user's privacy.
    4. Do not mislead our users.
    5. If the primary purpose of your application is to derive revenue, it is considered a commercial application.

    We believe that the developers who integrate with G2Reader.com are doing so with good motivations and I won't have any issues. However, should we discover that a client is acting against the interests of our customers then we reserve the right to disable your client_key if needed. These terms are subject to change.

    Limitation of Liability

    G2READER SHALL NOT, UNDER ANY CIRCUMSTANCES, BE LIABLE TO YOU FOR ANY INDIRECT, INCIDENTAL, CONSEQUENTIAL, SPECIAL OR EXEMPLARY DAMAGES ARISING OUT OF OR IN CONNECTION WITH USE OF THE G2READER API, WHETHER BASED ON BREACH OF CONTRACT, BREACH OF WARRANTY, TORT (INCLUDING NEGLIGENCE, PRODUCT LIABILITY OR OTHERWISE), OR ANY OTHER PECUNIARY LOSS, WHETHER OR NOT G2READER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. UNDER NO CIRCUMSTANCES SHALL G2READER BE LIABLE TO YOU FOR ANY AMOUNT.