iDreamBooks API

Introduction

iDreamBooks' API is intended for developers to access information about a certain title including its aggregated critic rating, critic review count and critic review snippets. iDreamBooks aggregates editorial reviews from professional critics like NYTimes and WashingtonPost to generate a highly authentic book rating.


Getting Started

  • You agree to iDreamBooks API Terms & Conditions
  • You will require an API key


  • Getting the Data

  • Critically Acclaimed Books

    This section provides ways to get a list of books recently recommended by top 20 publications like NYTimes, NPR, Washington Times. This data helps the users to discover and explore critically acclaimed books. There are two ways to access this data

    Critically Acclaimed Books as a Widget
    This method needs very little development work (just copy paste few lines). It show books recently recommended by top publications in the form of an iframe. Click here for more.

    Critically Acclaimed Books in JSON/XML format
    This method needs some development work and it provides up to 25 recently recommended books by top publications in the given genre. It allows you to customize the look and feel completely and also link the books back to your own site. Click here for more.


  • Books Featured in TV Shows

    This section provides ways to get a list of books recently featured in TV shows like Daily Show with Jon Stewart, The View, NPR Fresh Air. Click here for more.

  • Critic Reviews of a Book

    This section provides ways to get critic reviews of a book from various publications and an aggregated rating based on those reviews. It provides rich information about the book and helps the user in making informed decisions.

    Critic Reviews of a Book as a Widget
    This method needs very little development work (just copy paste few lines). It shows all the critic reviews of a book in the form of an iframe. Click here for more.

    Critic Reviews of a Book in JSON/XML format
    This method needs some development work. It provides up to 5 critic reviews and the overall critic rating of a book in JSON or XML format. It allows you to customize the look and feel completely and also link the books back to your own site. Click here for more.




  • Critically Acclaimed Books as a Widget

    The publication widget shows critically acclaimed books in the selected genre. To implement it copy and paste the following code in your website's HTML.

    Replace the EXAMPLE_KEY with a your api key. If you would like to link the books shown in this widget to the book pages on your site then please contact us at contact@idreambooks.com.

    by Book Reviews from top publications










    Critically Acclaimed Books in JSON/XML format

    You can get a list of critically acclaimed books by sending a HTTP GET request as shown below.

    {yourAPIkey} is an alpha-numeric api key that validates the request. The key can be obtained by filling out the API Key Form.

    {genre} is an optional input. When speicified the api returns books in that genre only otherwise it defaults to bestsellers in any genre. A list of allowed genre options is given below.

  • XML format

  • http://idreambooks.com/api/publications/recent_recos.xml?key={yourAPIkey}&slug={genre}


  • JSON format

  • http://idreambooks.com/api/publications/recent_recos.json?key={yourAPIkey}&slug={genre}












    Books Featured in TV Shows


    Shows for a book

    This api returns the show mentions for the specified book. It can be accessed by sending HTTP GET request as shown below.

    http://idreambooks.com/api/books/show_features.{format}?q={keywords}&key={yourAPIkey}
  • {keywords} is the search query for the book. It can be book ISBN or Title and/or Author e.g. 9781101475973, moonwalking with einstein or Bossypants by Tina Fey.
  • {format} can be either xml or json.
  • Example Response (returns list of show features for "Lean In" by Sheryl Sandberg):


    Recently featured books

    This api allows access to books featured in specified shows in the given time range. It can be accessed via following url:

    http://idreambooks.com/api/shows/books_featured.{format}?key={yourAPIkey}&shows={showIDs}
  • {showIDs} is a comma separated list of show ids for which books are returned e.g. 5687,5690 (you can also specify a single ID). The list of shows and their IDs is available here. If this parameter is not given, books featured in all shows are returned.
  • {startDate} and {endDate} specify the date range for the shows in yyyy-mm-dd format. These parameters can be used to return the books featured in the shows within a specific time period. If these parameters are not given, books featured in last 30 days are returned.
  • {sindex} is the start index of results (default is 0). The maximum number of books returned in one api call is 100. To get the rest of the books change this parameter to 100 and so on.
  • {format} can be either xml or json.
  • Example Response (returns list of books recently featured in all shows):









    Critic Reviews of a Book as a Widget

    You can embed all the critic reviews of a book by copying and pasting the following code in your website's HTML.

    Two inputs are required: "EXAMPLE_KEY" is an alpha-numeric key that validates the request, replace this with your api key and "ISBN" is the 10 or 13 digit isbn or eisbn of the book, replace this with the isbn of book. There are some optional parameters as well as explained in the above code snippet.


    The widget styling can be customized (requires Api Key)











    Critic Reviews of a Book in JSON/XML format

    You can get critic reviews for a book by sending a HTTP GET request as shown below.

    {keywords} in the request is the search query. It can be any of the following:

  • Book Title and/or Author
  • ISBN (10 or 13) or EISBN

  • {yourAPIkey} is an alpha-numeric key that validates the request. The key can be obtained by filling out the API Key Form.

  • XML format

  • http://idreambooks.com/api/books/reviews.xml?q={keywords}&key={yourAPIkey}


  • JSON format

  • http://idreambooks.com/api/books/reviews.json?q={keywords}&key={yourAPIkey}












    API Key Form

    Please fill out the form below to obtain an API key.
















    API Terms & Conditions

    When using our API, you agree to the following Terms & Conditions:

    • iDreamBooks' rating will always be displayed as a percentage. You can do so my adding the text “%” besides the rating. The rating will always be preceded or succeeded by the to-read-or-not icon. A smiley icon will be used if the rating is over 70% and a sad icon if it is less than 70%.
    • Since iDreamBooks' rating is based on critic reviews, it will be a stand-alone rating and will not be lumped with ratings based on user reviews.
    • Credit shall be given to iDreamBooks by either linking the rating and the icon to the relevant book page on iDreamBooks or by displaying and linking the following text besides the rating to the relevant book page on iDreamBooks: '{Title of book} reviews from idreambooks.com'.
    • If you wish to display the snippets, they should be in a separate section than user reviews and should be labelled appropriately. A label to the effect of “Editorial Reviews” or “Book Reviews by Critics” or {Title of book} Reviews from iDreamBooks” should help distinguish between critics reviews & user reviews. Underneath the section of snippets you wish to display, credit shall be given to iDreamBooks by displaying and linking the following text to the relevant book page on iDreamBooks: '{Title of book} reviews from idreambooks.com'.
    • Up to 5 snippets will be sent as part of the response. Depending on whether the snippet is positive or negative, a smiley or sad icon will be sent for a given snippet. When displaying the snippet, the relevant icon can be displayed too.
    • You agree to not use the API to redistribute, harvest or index iDreamBooks' data without our explicit consent.
    • You agree to not truncate, modify or change our data.
    • You may not store our data except for caching purposes.
    • You may not nofollow any of the required links, as mentioned above, to iDreamBooks' pages.
    • iDreamBooks reserves the right to suspend your account for violation of the above terms. We also reserve the right to update or modify these terms without prior notice.