Skip to content

Repository files navigation

@citation-js/plugin-isbn

Thie plugin adds support for ISBN numbers through a variety of APIs.

NPM version Codecov NPM total downloads License

Install

npm install @citation-js/plugin-isbn

Browser

Make a build with @citation-js/plugin-isbn on the build tool!

Use

import '@citation-js/plugin-isbn'

Or install the plugin by require-ing it:

require('@citation-js/plugin-isbn')

Formats

Formats and other features added by this plugin.

ISBN identifiers

  • ISBN-10 (@isbn/isbn-10)
  • ISBN-13 (@isbn/isbn-13)
  • ISBN-A (actionable ISBN, @isbn/isbn-a)

Open Library API

The other API used in this plugin is the Open Library Books API. It returns the following information:

  • authors,
  • page count,
  • publisher,
  • publication date,
  • publication place,
  • keywords,
  • title, and
  • URL.

Google Books API

The Google Books API seems to no longer be available to the public, and has been disabled by default.

One of the few public, free APIs to resolve ISBNs is the Google Books API. It returns volumes, which contain information on the

  • authors,
  • entity type (magazine or book),
  • categories/keywords,
  • description,
  • dimensions,
  • language,
  • page count,
  • publisher,
  • title,
  • publication date, and
  • a (Google Books) URL.

For the heck of it, this plugin also support creating API responses from existing metadata. This benefits no one.

Configuration

APIs

Configure which APIs are called and in what order.

import { plugins } from '@citation-js/core'

const config = plugins.config.get('@isbn)
config.api = ['googlebooks', 'openlibrary']

Releases

Used by

Contributors

Languages