Skip to content

A federated search API for finding image thumbnails for book covers.

License

Notifications You must be signed in to change notification settings

e-e-e/bookcovers

Repository files navigation

bookcovers

A federated search API for finding image thumbnails for book covers.

Performs a combined search of Amazon, Google Books and Open Library to find thumbnails corresponding to isbn numbers.

bookcovers is node library and cli tool. It currently does not work in browser environments.

Install

npm i -g bookcovers

Example Usage

As a library within a node application:

const bookcovers = require("bookcovers");

bookcovers
  .withIsbn("9781570273148")
  .then(results => ...);

As a cli:

bookcovers <isbn>;
# logs out book cover data in the form "<source> <size> <url>"

Specify which service to use:

bookcovers <isbn> --type amazon;
# only searches Amazon

API

bookcovers.withIsbn(isbn: string, options?: { ... });

Returns a promise that resolves to an object containing urls from each of the sources.

{
  amazon: {
    '1x': 'https://m.media-amazon.com/images/I/51z2HY7kn4L._AC_UY218_ML3_.jpg',
    '1.5x': 'https://m.media-amazon.com/images/I/51z2HY7kn4L._AC_UY327_FMwebp_QL65_.jpg',
    '2x': 'https://m.media-amazon.com/images/I/51z2HY7kn4L._AC_UY436_FMwebp_QL65_.jpg',
    '2.2935x':'https://m.media-amazon.com/images/I/51z2HY7kn4L._AC_UY500_FMwebp_QL65_.jpg'
  },
  google: {
    smallThumbnail: 'http://books.google.com/books/content?id=wDVV6y-8YHEC&printsec=frontcover&img=1&zoom=5&source=gbs_api',
    thumbnail: 'http://books.google.com/books/content?id=wDVV6y-8YHEC&printsec=frontcover&img=1&zoom=1&source=gbs_api'
  },
  openLibrary: {
    small: 'http://ia801606.us.archive.org/zipview.php?zip=/26/items/olcovers36/olcovers36-S.zip&file=369091-S.jpg',
    medium: 'http://ia801606.us.archive.org/zipview.php?zip=/26/items/olcovers36/olcovers36-M.zip&file=369091-M.jpg',
    large: 'http://ia801606.us.archive.org/zipview.php?zip=/26/items/olcovers36/olcovers36-L.zip&file=369091-L.jpg'
  }
}

Options

  • type - Specify a service: 'amazon' | 'google' | 'openLibrary'. Default: null (all).
  • amazon - Specify additional options for puppeteer amazon scraper
  • google - Specify additional options for request google scraper
  • openLibrary - Specify additional options for request open library scraper

About

A federated search API for finding image thumbnails for book covers.

Resources

License

Stars

Watchers

Forks

Packages

No packages published