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, commision, etc.

Getting textbook 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 retrieved successfully for various textbook conditions.

Getting textbook buy/rent 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/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","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":"success","text":{"Average":{"Buy":27.56,"Rent":"Not available"},"Good":{"Buy":35.20,"Rent":{"120":30.05,"90":28}},"New":{"Buy":"Not available","Rent":"Not available"}}}} - indicates that purchase/rent price has been retrieved successfully for various textbook conditions and rental terms (days).

Adding textbooks to buyback cart by ISBN number

The sample url for adding textbook 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 book 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 textbooks to buy/rent cart by ISBN number and condition

The sample url for adding textbook to cart for purchase is shown below:

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

Where 1464108730 is ISBN to add. Possible condition values are: Average, Good or New and 99 is your affiliate id. If the book is going to rent, add the suffix :rent:{days} instead of :buy after condition parameter:

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

Multiple ISBNs are also supported:

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

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

December 8th, 2016