Nothing, Plus More

    @chewhx/google-books
    TypeScript icon, indicating that this package has built-in type declarations

    3.0.1 • Public • Published

    @chewhx/google-books

    NodeJS Wrapper to search for books on Google Books API.

    Installation

      npm install @chewhx/google-books

    Report issues or bugs

    Create a new issue here. Set the label to "bug".

    Imports

    const gbooks = require('@chewhx/google-books');
    // OR
    import gbooks from '@chewhx/google-books'

    How to use

    All methods returns a promise.

    Search for a book

    gbooks.search('atomic habits').then((res)=>console.log(res))

    Search for a book with standard parameters

    gbooks.search('atomic habits', {inauthor:'James Clear'}).then((res)=>console.log(res))

    Search for a book with standard parameters and api parameters

    gbooks.search('atomic habits', {inauthor:'James Clear'}, {maxResults: 10}).then((res)=>console.log(res))

    Search for a book with ONLY standard parameters, and api parameters

    gbooks.standard({intitle: 'atomic habits', inauthor:'James Clear'}, {maxResults: 10}).then((res)=>console.log(res))

    Search for book with google books id

    gbooks.id("lFhbDwAAQBAJ").then((res)=>console.log(res))

    Search for book with only title

    gbooks.title("atomic habits").then((res)=>console.log(res))

    Search for book with only author

    gbooks.author("james clear").then((res)=>console.log(res))

    Search for book with only isbn

    gbooks.isbn("978-0735211292").then((res)=>console.log(res))

    API

    Standard Parameters

    standardParams is an object containing the follow properties. See full definition here.

    Refer to docs for more detail

    type StandardQueryParameters = {
      q: string;
      intitle?: string;
      inauthor?: string[] | string;
      inpublisher?: string[] | string;
      subject?: string[] | string;
      isbn?: string[] | string;
      lccn?: string[] | string;
      oclc?: string[] | string;
    };

    API Parameters

    apiParams is an object containing the following properties. See full definition here.

    Refer to docs for more details

    type ApiQueryParameters = {
    	download?: 'epub';
    	filter?: 'partial' | 'full' | 'free-ebooks' | 'paid-ebooks' | 'ebooks';
    	langRestrict?:| 'aa'| 'ab'| 'ae'| 'af'| 'ak'| 'am'| 'an'| 'ar'| 'as'| 'av'| 'ay'| 'az'| 'ba'| 'be'| 'bg'| 'bh'| 'bi'| 'bm'| 'bn'| 'bo'| 'br'| 'bs'| 'ca'| 'ce'| 'ch'| 'co'| 'cr'| 'cs'| 'cu'| 'cv'| 'cy'| 'da'| 'de'| 'dv'| 'dz'| 'ee'| 'el'| 'en'| 'eo'| 'es'| 'et'| 'eu'| 'fa'| 'ff'| 'fi'| 'fj'| 'fo'| 'fr'| 'fy'| 'ga'| 'gd'| 'gl'| 'gn'| 'gu'| 'gv'| 'ha'| 'he'| 'hi'| 'ho'| 'hr'| 'ht'| 'hu'| 'hy'| 'hz'| 'ia'| 'id'| 'ie'| 'ig'| 'ii'| 'ik'| 'io'| 'is'| 'it'| 'iu'| 'ja'| 'jv'| 'ka'| 'kg'| 'ki'| 'kj'| 'kk'| 'kl'| 'km'| 'kn'| 'ko'| 'kr'| 'ks'| 'ku'| 'kv'| 'kw'| 'ky'| 'la'| 'lb'| 'lg'| 'li'| 'ln'| 'lo'| 'lt'| 'lu'| 'lv'| 'mg'| 'mh'| 'mi'| 'mk'| 'ml'| 'mn'| 'mr'| 'ms'| 'mt'| 'my'| 'na'| 'nb'| 'nd'| 'ne'| 'ng'| 'nl'| 'nn'| 'no'| 'nr'| 'nv'| 'ny'| 'oc'| 'oj'| 'om'| 'or'| 'os'| 'pa'| 'pi'| 'pl'| 'ps'| 'pt'| 'qu'| 'rm'| 'rn'| 'ro'| 'ru'| 'rw'| 'sa'| 'sc'| 'sd'| 'se'| 'sg'| 'si'| 'sk'| 'sl'| 'sm'| 'sn'| 'so'| 'sq'| 'sr'| 'ss'| 'st'| 'su'| 'sv'| 'sw'| 'ta'| 'te'| 'tg'| 'th'| 'ti'| 'tk'| 'tl'| 'tn'| 'to'| 'tr'| 'ts'| 'tt'| 'tw'| 'ty'| 'ug'| 'uk'| 'ur'| 'uz'| 've'| 'vi'| 'vo'| 'wa'| 'wo'| 'xh'| 'yi'| 'yo'| 'za'| 'zh'| 'zu';
    	maxResults?: number;
    	orderBy?: 'relevance' | 'newest';
    	printType?: 'all' | 'books' | 'magazines';
    	projection?: 'full' | 'lite';
    	startIndex?: number;
    	volumeId?: string;
    };

    Install

    npm i @chewhx/google-books

    DownloadsWeekly Downloads

    17

    Version

    3.0.1

    License

    MIT

    Unpacked Size

    25.7 kB

    Total Files

    36

    Last publish

    Collaborators

    • chewhx