API Documentation

If you want to integrate SharedBookshelves.com into your church website (like to display all the titles owned by your church family) you now can using our Application Programming Interface (API). This document is the official reference for that functionality.

Note: Your church_id can be found by signing in and going to your profile, and the last number in the link to your church is what you're after. Links to church pages are of the format:

sharedbookshelves.com/church/[country]/[region]/[city]/[name]/[church_id]

Return list of owned books

http://sharedbookshelves.com/api/getdata.xml?church_id=1
By default, page = 1, results_per_page = 10, list = owned

Return wish list

http://sharedbookshelves.com/api/getdata.xml?church_id=1&page=2&list=wish&results_per_page=20&orderby=title
Ordering is according to frequency by default but can also be set according to title ("&orderby=title") or added date ("&orderby=added")

Search owned list for books with "Gospel in the title"

http://sharedbookshelves.com/api/getdata.xml?church_id=1&q=Gospel&type=1

Return books with "Lewis" as the author from wish list

http://sharedbookshelves.com/api/getdata.xml?church_id=1&q=Lewis&type=2

See example code for parsing the data using cURL and PHP.