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.
All methods are GET requests, default responses are XML, but you can also request JSON and JSONP
format: specify output format (
callback: specify a callback name for jsonp requests (format:
Returns the last time chapter, character, and location data were updated.
Returns a chapter and corresponding metadata. A request without any arguments returns list of all chapters.
chapter: specify chapter (
id: specify whether headlines and titles include anchor IDs, defaults to no (format:
Returns a character and a list of associated chapters. A request without any arguments returns list of all characters, organized by type.
id: specify character id
Returns a location and related chapters. A request without any arguments returns list of all locations. (Note: not all chapters have location data.)
id: specify location id number
Runs full-text keyword search of chapters.
keywords: specify search terms, separate words with
If something goes wrong, you’ll get an enigmatic:
<result>Something went wrong!</result>