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.


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 personal access key. The possible responses are listed below:

  • Indicates that access key is invalid or has expired
  {
    "result": {
      "status": "error",
      "text": "Wrong API access key"
    }
  }
  • Indicates that submitted ISBN does not match 10 or 13 digits criteria
  {
    "result": {
      "status": "error",
      "text": "Wrong Isbn"
    }
  }
  • Indicates no price information has been found for submitted ISBN
  {
    "result": {
      "status": "error",
      "text":"Isbn not found"
    }
  }
  • Indicates that 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:

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.


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 personal access key. The possible responses are listed below:

  • Indicates that access key is invalid or has expired
  {
    "result": {
      "status": "error",
      "text": "Wrong API access key"
    }
  }
  • Indicates that submitted ISBN does not match 10 or 13 digits criteria
  {
    "result": {
      "status": "error",
      "text": "Wrong Isbn"
    }
  }
  • Indicates that price list has been retrieved successfully for various items
  {
    "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"
          }
        ]
      }
    }
  }

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

January 14th, 2020