app-engine app for proxying readability content api requests
Python Other
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.

Readability app-engine content proxy

A simple, memcached based throttling proxy for Readability's content API which can run on google app engine.

This runs on google app engine. It's also easy to run locally. You will need to have the ol' python app engine runtime installed.

A sample is up at

There is only one endpoint, / , which proxies requests to the readability content parser. There is one required parameter, url which must be a nicely encoded url e.g.

The second optional parameter is callback which lets you use this across domains using jsonp. Calls will be returned with content-type application/javascript if this parameter is passed and content will return like so:


otherwise content will be returned as application/json.


Configuration is done in Two config variables can be set:

  • RDB_TOKEN: Your Readability content api token (do not check this into a public repo!)
  • MINUTE_LIMIT: The number of requests, per minute, to allow. This is alimit based on the ip of the requesting user.


Just proxy the content for one article and return the response:

Make a request for jsonp:

Make a request with a url that has url params (see how it's escaped?):