FAQ

Getting Started: Using the API

Welcome to ISBNdb.com. New users will automatically be using API 2.0. Users prior to May 2019 have the option of using API 1.0 until May 1 2020 when it will no longer be supported. Your API key is accessible in your user dash and in your welcome email as well.

API 2.0

The API 2 URL is api2.isbndb.api.com.

Please make sure your code is formatted correctly according to our code examples on the API doc:

https://isbndb.com/apidocs/v2

You may also test your key in the API doc directly to confirm it is working properly. Select the "Authorize " button on the API docs page and enter your key; then select a Get subject and the "Try it out" button; paste your key there to execute and confirm it is working.

The most common errors are unauthorized key or limits exceeded; your subscription must be current for your key to be authorized. If you exceed your daily call limits in a 24 hour period, the key will no longer work the remainder of that day.

For new subscribers, there is a 500 daily call limit during the 7 day free trial. After the 7 days your plan call limits will automatically reset to the higher call limits of the plan you subscribed to. At any time during the trial, you may bypass the trial using the button in your dashboard to immediately begin the subscription plan at the higher call limits.

The API data fields are ISBN, ISBN13, title, author, list price, publisher, publish date, edition, format, cover image, subject, pages, dimensions, binding, overview, and language.

The Premium plan offers all data fields, as well as bulk data which allows you to call up to 1000 books with 1 API call.

The Pro plan offers all data fields, bulk data, and also real time prices.

API 1.0

We will continue to support the previous version of the API until May 1, 2020.

API 1.0 has different functionality than API 2.0, so please make sure your code is formatted properly if you are still using the older API:

https://isbndb.com/apidocs

You may also test your key in the API doc directly to confirm it is working properly. Select the "Authorize " button on the API docs page and enter your key; then select a Get subject and the "Try it out" button; paste your key there to execute and confirm it is working.

The most common errors are unauthorized key or limits exceeded; your subscription must be current for your key to be authorized. If you exceed your daily call limits in a 24 hour period, the key will no longer work the remainder of that day.

Account Management

After you have created and verified your account, you will have access to the ISBNdb API plan that you have chosen. Your API key is available in your dashboard and will remain authorized as long as you remain subscribed to your plan.

In your account dashboard, you can monitor your API usage, edit your profile, change plans, or cancel your subscription.

The dashboard display shows your trailing 30 day usage of the API so you can monitor your usage.

From the dash, you can also edit any of your profile information. Please note if you change your email, you will need to also update your paypal payments to remain subscribed.

To change plans, select the "Switch Plans" button in your dash, and then select the new plan you want. Follow the instructions to complete the switch (please note there is no trial period for a switch nor can we prorate any funds to the new plan). Your API key will remain the same and will have the new daily call limits of the plan you switched to.

To cancel your subscription, select the "Edit Profile" button from the dash and scroll to bottom and select "cancel account". Your ISBNdb key and account will be deleted if you select this option. Please note you must also cancel your PayPal payments through your PayPal dashboard.

Billing Questions

ISBNdb currently accepts PayPal as our primary form of payment. We are working on offering alternative payment methods in the future. Once your subscription is setup, your payments will process automatically through PayPal each month until you cancel your account. We are unable to offer refunds for any plans or unused calls. You may cancel your plan at any time through your dashboard; please note you must also cancel your PayPal payments through your PayPal dashboard.

If you are interested in prepaying for an annual plan, we also offer check, wire, and credit card payments. Contact us at support@isbndb.com for alternate payment options on annual plans.

ISBNdb is a unique book database with over 20 millions titles that complies various data points for each book and makes that data available to users on ISBNdb and to other websites and apps via our API. You can search by ISBN, title, author, publisher, date, and more.
The database is constantly growing, and is currently close to 20 million titles and counting. Our live database statistics on our homepage display the exact number of books available. The database is continually updated, with more books and more data points for existing books continually being added.

Each book includes Title, ISBN and ISBN13, Publisher, Author, Edition, Subject, Overview, Dimensions, dewey decimal, publication date, format, price and historical pricing (when available)

Our database is constantly being expanded as it crawls libraries, publishers, and other websites to include as many books as possible.
Becoming a member of ISBNdb.com will allow you to use our API on your website to parse book information in real time. You can access all of the ISBNdb data on a real time basis, and you will only be charged based on the number of API calls you make. ISBNdb can work as your primary or backup database for your website or app, and is much more cost effective than convential book databases.
We don’t currently offer this feature, but we are working on adding this functionality in the near future.
At this moment, this feature is not available on the site. However, we will be experimenting with user-based manual input of titles onto the database soon. This will allow visitors to request a title to be displayed on ISBNdb.com, and if it passes review, will come up in our search results.
Please send information about any found errors in our data to support@isbndb.com. If you don’t see the answer to your question here, please contact us.
Desk Copies are available directly from publishers. ISBNdb.com is not a publishing company so we are unable to provide desk copies to faculty or staff; however you may search ISBNdb for your book to determine who the publisher is and then contact them directly.
ISBNdb.com provides data on books, including author’s name and publication date, however we are unable to provide contact information for authors. Each author is different; some make it easy to contact them while others prefer their privacy. Your best bet is to search ISBNdb for your book to discover your author’s name and publisher; then search the publisher or author’s website for their contact information. You may also try to follow or contact the author on social media.
Our database is continually updated by gathering data from a variety of sources across the Internet. If you have recently published a book, or a book that you know about is not listed, it hasn’t been made available through any of our data sources. If you wish your book to be added, please send us the ISBN through the contact us link.
Non-profit organizations can get discounted access to the database by providing proof of 501(c)(3) status from the IRS.
No, calls do not get rolled over. If you use 10 calls of the 100 call daily limit, you will still only have 100 calls the next day.
You can mail a check paying month-by-month or in advance for three, six, or even one year of service. Please mail checks to:
Price Network Inc. 
PO Box 25 
Cardiff, CA 92024
SBNdb employs a REST API, which means that it is not specifically tied to any language or platform. You can have REST clients for pretty much every language or platform out there.

Click here for more information on how restful APIs work

.
Most issues with the API can be solved by looking at our documentation found here.

While we attempt to help all of our users find their way around our API and resolve any bugs they might be encountering, our support access is limited to a certain number of users per day. Unless the API is simply not working for you (and you are using a supported platform) we can try to figure out what is happening.