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/v3/price/buy/0134093410?key=XYZ

Where 0134093410 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!","offers":""}} - indicates that access key is invalid or has expired,

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

{
  "result":{
    "status":"success",
    "message":"",
    "offers":{
      "booksrun":{
        "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":{
          "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"
          }
        }
      },
      "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"
        }
      ]
    }
  }
}
- indicates that price list has been retrieved successfully for various items.

We also support dropshipping buy API, for the details please contact customer support.

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.

October 31st, 2019