API Reference

Once you are signed up with us you will receive an API key which you must use as url parameter for each API call so that we can identify you. Also, you will receive personalized affiliate user account where you can track your queries, sales, commission, etc.

Getting item's buyback price by ISBN number

The sample URL for GET request for standard ISBN (10 or 13 digits) is shown below:

http://booksrun.com/api/price/sell/1464108730?key=XYZ

Where 1464108730 is ISBN to search for and XYZ is personal access key. The possible responses are listed below:

{"result":{"status":"error","text":"Wrong API access key"}} - indicates that access key is invalid or has expired,

{"result":{"status":"error","text":"Wrong Isbn"}} - indicates that submitted ISBN does not match 10 or 13 digits criteria,

{"result":{"status":"error","text":"Isbn not found"}} - indicates no price information has been found for submitted ISBN,

{"result":{"status":"success","text":{"Average":7.91,"Good":8.47,"New":8.75}}} - indicates that buyback price has been successfully retrieved for various item conditions.

Getting item's buy/rent price by ISBN number

The sample URL for GET request for standard ISBN (10 or 13 digits) is shown below:

https://booksrun.com/api/v2/price/buy/1464108730?key=XYZ

Where 1464108730 is ISBN to search for and XYZ is personal access key. The possible responses are listed below:

{"result":{"status":"error","message":"Wrong API access key!","payload":""}} - indicates that access key is invalid or has expired,

{"result":{"status":"error","message":"Wrong Isbn!","payload":""}} - indicates that submitted ISBN does not match 10 or 13 digits criteria,

{"result":{"status":"success","message":"","payload":{"used":35.20,"new":39.20,"rent":{"120":30.05,"90":28.90},"ebook":34.94}}} - indicates that purchase/rent price has been retrieved successfully for various item conditions and rental terms (days),

{"result":{"status":"success","message":"","payload":{"used":"none","new":39.20,"rent":"none","ebook":"none"}}} - indicates that price is available for New condition only.

Adding items to buyback cart by ISBN number

The sample URL for adding item to cart is shown below:

https://booksrun.com/api/cart/sell/add/1464108730?afk=99

Where 1464108730 is ISBN to add and 99 is your affiliate id. Multiple ISBNs are also supported:

https://booksrun.com/api/cart/sell/add/1464108730,067443000X?afk=99

If you would like to specify item condition (average, good or new) to be added to seller cart, consider the following example:

https://booksrun.com/api/cart/sell/add/1464108730:good,067443000X:new?afk=99

On successful validation user is redirected to cart with selected ISBNs added.

Adding items to buy/rent cart by ISBN number and condition

The sample URL for adding used book to cart for purchase is shown below:

https://booksrun.com/api/v2/cart/buy/add/1464108730:used?afk=99

Where 1464108730 is ISBN to add. Possible condition values are: used or new and 99 is your affiliate id. If the book is going to rent, add the suffix :rent:{days} after ISBN:

https://booksrun.com/api/v2/cart/buy/add/1464108730:rent:90?afk=99

Multiple ISBNs are also supported:

https://booksrun.com/api/v2/cart/buy/add/1464108730:rent:120,067443000X:new?afk=99

On successful validation user is redirected to cart with selected ISBNs added. E-books are also supported:

https://booksrun.com/api/v2/cart/buy/add/1464108730:ebook?afk=99

July 30th, 2018