Humphry Clinker API v1.0

The API lets your applications programmatically interact with main text from the book, as well as extra metadata. It requires no authentication and is not rate-limited in any way. But please be kind on my server. If you need to use it a lot, perhaps you should download your own copy of this book from Github. Find me on Twitter, and I’ll help you set it up.

Methods

All methods are GET requests, default responses are XML, but you can also request JSON and JSONP

URL Parameters

http://books.ayellowraven.com/expedition-of-humphry-clinker/api/v1

Returns the last time chapter, character, and location data were updated.

http://books.ayellowraven.com/expedition-of-humphry-clinker/api/v1/chapter

Returns a chapter and corresponding metadata. A request without any arguments returns list of all chapters.

URL Parameters

http://books.ayellowraven.com/expedition-of-humphry-clinker/api/v1/character

Returns a character and a list of associated chapters. A request without any arguments returns list of all characters, organized by type.

URL Parameters

http://books.ayellowraven.com/expedition-of-humphry-clinker/api/v1/location

Returns a location and related chapters. A request without any arguments returns list of all locations. (Note: not all chapters have location data.)

URL Parameters

http://books.ayellowraven.com/expedition-of-humphry-clinker/api/v1/search

Runs full-text keyword search of chapters.

URL Parameters

Error Handling

If something goes wrong, you’ll get an enigmatic:

<result>Something went wrong!</result>