Free Book API

Free Book API Support
The API and site will always remain free at point of access.

Test API Keys
You can use the test API key "1" during development of your app or for educational use (see test links below).
However you must become a supporter if releasing publicly on an appstore.

API Production Key Upgrade
All supporters have access to the beta version of the API which allows mutiple ingredient filters.
You also get access to adding your own books and images. You can also list the full database rather than limited to 100 items.
Please sign up on Paypal and we will email you the upgraded API key.

Contact
Email: thedatadb (at) gmail.com

V1 API

API Methods using the developer test key '1' in the URL

Search book by name

www.thebookdb.net/api/json/v1/1/search.php?s=harry_potter

List all books by first letter

www.thebookdb.net/api/json/v1/1/search.php?f=a

Lookup full book details by id

www.thebookdb.net/api/json/v1/1/lookup.php?i=52772

Lookup a single random book

www.thebookdb.net/api/json/v1/1/random.php

Lookup a selection of 10 random books

*Premium API Only
www.thebookdb.net/api/json/v1/1/randomselection.php

List all book categories

www.thebookdb.net/api/json/v1/1/categories.php

Latest Books

*Premium API Only
www.thebookdb.net/api/json/v1/1/latest.php

List all Categories, Area, Ingredients

www.thebookdb.net/api/json/v1/1/list.php?c=list
www.thebookdb.net/api/json/v1/1/list.php?a=list
www.thebookdb.net/api/json/v1/1/list.php?i=list

Filter by main ingredient

www.thebookdb.net/api/json/v1/1/filter.php?i=chicken_breast

Filter by multi-ingredient

*Premium API Only
www.thebookdb.net/api/json/v1/1/filter.php?i=chicken_breast,garlic,salt

Filter by Category

www.thebookdb.net/api/json/v1/1/filter.php?c=Seafood

Filter by Area

www.thebookdb.net/api/json/v1/1/filter.php?a=Canadian

Book Thumbnail Images

Add /preview to the end of the book image URL
/images/media/books/llcbn01574260722.jpg/small
/images/media/books/llcbn01574260722.jpg/medium
/images/media/books/llcbn01574260722.jpg/large

Ingredient Thumbnail Images

*URL's match the ingredient name with an underscore for any spaces.

www.thebookdb.net/images/ingredients/lime.png
www.thebookdb.net/images/ingredients/lime-small.png
www.thebookdb.net/images/ingredients/lime-medium.png
www.thebookdb.net/images/ingredients/lime-large.png