Book Price 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 a personalized affiliate user account where you can track your queries, sales, commission, etc.
Please note that Buyback and Buy/Rent requests will differ in the API versions and how their URL links are structured.
BUYBACK
Getting item's buyback price by ISBN number
The sample URL for GET request for standard ISBN (10 or 13 digits) is shown below:
https://booksrun.com/api/price/sell/1464108730?key=XYZ
Where 1464108730 is ISBN to search for and XYZ is a personal access key. The possible responses are listed below:
- Indicates that the access key is invalid or has expired:
{ "result": { "status": "error", "text": "Wrong API access key" } }
- Indicates that the submitted ISBN doesn't match 10 or 13 digits criteria:
{ "result": { "status": "error", "text": "Wrong Isbn" } }
- Indicates no price information has been found for the submitted ISBN:
{ "result": { "status": "error", "text":"Isbn not found" } }
- Indicates that the buyback price has been successfully retrieved for various item conditions:
{ "result": { "status": "success", "text": { "Average": 7.91, "Good": 8.47, "New": 8.75 } } }
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 (a maximum of 3 ISBNs is allowed per request):
https://booksrun.com/api/cart/sell/add/1464108730,067443000X?afk=99
If you would like to specify the item condition (average, good, or new) to be added to the seller cart, consider the following example:
https://booksrun.com/api/cart/sell/add/1464108730:good,067443000X:new?afk=99
On successful validation, the user is redirected to the cart with selected ISBNs added.
BUY/RENT
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/v3/price/buy/0134093410?key=XYZ
Where 0134093410 is ISBN to search for and XYZ is the personal access key. The possible responses are listed below:
- Indicates that the access key is invalid or has expired:
{ "result": { "status": "error", "message": "Wrong API access key" } }
- Indicates that the submitted ISBN doesn't match 10 or 13 digits criteria:
{ "result": { "status": "error", "message": "Wrong Isbn" } }
- Indicates that the price list has been retrieved successfully for various items. "booksrun" usually includes our purchase and rental offers. "ebook", "marketplace" and "international offers" are other categories which are stated in separate quotation marks and start with a new text block. The shipping costs are shown for each category individually.
{ "result": { "status": "success", "message": "", "offers": { "booksrun": {
- Purchase offers for used and new conditions. The number in quotation marks for a rental offer means the rental period (it may be 35 days, 50 days, 90 days, and longer):
"used": { "price": 112.72, "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/0134093410-11-1?afk=99" }, "new": { "price": 125.69, "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/0134093410-9-10?afk=99" }, "rent": { "35": { "price": 37.59, "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/0134093410-9-10:rent:35?afk=99" }, "53": { "price": 44.36, "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/0134093410-9-10:rent:53?afk=99" } }, "shipping": 0,
- Ebook offers which we offer to buy and rent:
"ebook": { "perpetual": { "price": "155.99", "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/9780134446417:ebook?afk=99" }, "180": { "price": "105.99", "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/9780134446417R180:ebook?afk=99" } } },
- The offers of our marketplace sellers with the state code they ship from. "none" for new means that a book in new condition is out-of-stock:
"marketplace": [ { "seller": "Seller 42", "shipping":3.99, "ships_from": "PA", "used": { "price": 28.66, "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/9780134093413_7_peq:42?afk=99", "condition": "Acceptable" }, "new":"none" } ],
- Purchase offers we ship globally. The below sample shows the data for a used item we are ready to ship to Canada (CA), Australia (AU), Germany (DE), and the United Kingdom (UK):
"international_shipping": [ { "country": "CA", "shipping": 12.99, "used": { "price": 21.64, "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/1292170433-11-1-7?afk=99" }, "new": "none" }, { "country": "AU", "shipping": 14.99, "used": { "price": 21.64, "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/1292170433-11-1-7?afk=99" }, "new": "none" }, { "country": "DE", "shipping": 14.49, "used": { "price": 21.64, "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/1292170433-11-1-7?afk=99" }, "new": "none" }, { "country": "UK", "shipping": 9.49, "used": { "price": 21.64 "cart_url": "https:\/\/booksrun.com\/user\/buy\/cart\/add\/1292170433-11-1-7?afk=99" }, "new": "none" } ] } } }
Making purchase orders programmatically
We also support dropshipping auto buy API (you connect your credit card, and we ship books to the address from your API call on autopilot), for the details, see the autobuy page.
FTP inventory for bulk buyers
For those who buy a lot of books from us and want to save on shipping, we provide daily FTP inventory files for bulk orders. For details, see the bulk buying page.