Books - overview

Example

example.js

const { Books } = require('nytimes-api');
const books = new Books('your-super-secret-api-key');

books.overview(data => console.log(data));

What does it do?

overview gets the most recent top 5 books from every available list. The code above does the same.

Example Response

example-response.json

{ bestsellers_date: '2019-02-16',
  published_date: '2019-03-03',
  published_date_description: 'latest',
  previous_published_date: '2019-02-24',
  next_published_date: '',
  lists:
   [ { list_id: 704,
       list_name: 'Combined Print and E-Book Fiction',
       list_name_encoded: 'combined-print-and-e-book-fiction',
       display_name: 'Combined Print & E-Book Fiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780735219090.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] },
     { list_id: 708,
       list_name: 'Combined Print and E-Book Nonfiction',
       list_name_encoded: 'combined-print-and-e-book-nonfiction',
       display_name: 'Combined Print & E-Book Nonfiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781524763138.jpg',
       list_image_width: 326,
       list_image_height: 495,
       books: [Array] },
     { list_id: 1,
       list_name: 'Hardcover Fiction',
       list_name_encoded: 'hardcover-fiction',
       display_name: 'Hardcover Fiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780735219090.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] },
     { list_id: 2,
       list_name: 'Hardcover Nonfiction',
       list_name_encoded: 'hardcover-nonfiction',
       display_name: 'Hardcover Nonfiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781524763138.jpg',
       list_image_width: 326,
       list_image_height: 495,
       books: [Array] },
     { list_id: 17,
       list_name: 'Trade Fiction Paperback',
       list_name_encoded: 'trade-fiction-paperback',
       display_name: 'Paperback Trade Fiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780062797155.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] },
     { list_id: 4,
       list_name: 'Paperback Nonfiction',
       list_name_encoded: 'paperback-nonfiction',
       display_name: 'Paperback Nonfiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780062316097.jpg',
       list_image_width: 128,
       list_image_height: 192,
       books: [Array] },
     { list_id: 24,
       list_name: 'Advice How-To and Miscellaneous',
       list_name_encoded: 'advice-how-to-and-miscellaneous',
       display_name: 'Advice, How-To & Miscellaneous',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781400201655.jpg',
       list_image_width: 325,
       list_image_height: 495,
       books: [Array] },
     { list_id: 13,
       list_name: 'Childrens Middle Grade Hardcover',
       list_name_encoded: 'childrens-middle-grade-hardcover',
       display_name: 'Children’s Middle Grade Hardcover',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780375899881.jpg',
       list_image_width: 329,
       list_image_height: 495,
       books: [Array] },
     { list_id: 7,
       list_name: 'Picture Books',
       list_name_encoded: 'picture-books',
       display_name: 'Children’s Picture Books',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780448489322.jpg',
       list_image_width: 330,
       list_image_height: 403,
       books: [Array] },
     { list_id: 10,
       list_name: 'Series Books',
       list_name_encoded: 'series-books',
       display_name: 'Children’s Series',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780545935210.jpg',
       list_image_width: 330,
       list_image_height: 488,
       books: [Array] },
     { list_id: 14,
       list_name: 'Young Adult Hardcover',
       list_name_encoded: 'young-adult-hardcover',
       display_name: 'Young Adult Hardcover',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780062498564.jpg',
       list_image_width: 329,
       list_image_height: 499,
       books: [Array] },
     { list_id: 301,
       list_name: 'Audio Fiction',
       list_name_encoded: 'audio-fiction',
       display_name: 'Audio Fiction',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780735219090.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] },
     { list_id: 302,
       list_name: 'Audio Nonfiction',
       list_name_encoded: 'audio-nonfiction',
       display_name: 'Audio Nonfiction',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781524763138.jpg',
       list_image_width: 326,
       list_image_height: 495,
       books: [Array] },
     { list_id: 532,
       list_name: 'Business Books',
       list_name_encoded: 'business-books',
       display_name: 'Business',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781524731663.jpg',
       list_image_width: 330,
       list_image_height: 493,
       books: [Array] },
     { list_id: 531,
       list_name: 'Science',
       list_name_encoded: 'science',
       display_name: 'Science',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780062316097.jpg',
       list_image_width: 128,
       list_image_height: 192,
       books: [Array] },
     { list_id: 538,
       list_name: 'Sports',
       list_name_encoded: 'sports',
       display_name: 'Sports and Fitness',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781501135934.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] } ] }

C:\Users\jacob\Coding\nytimes-api>node index
[]

C:\Users\jacob\Coding\nytimes-api>node index
[ { url:
     'https://www.nytimes.com/2018/11/16/books/review/tattooist-auschwitz-heather-morris.html',
    publication_dt: '2018-11-16',
    byline: 'CHRISTINA BAKER KLINE',
    book_title: 'The Tattooist of Auschwitz',
    book_author: 'Heather Morris',
    summary:
     'The British actor Richard Armitage delivers a masterly reading of Heather Morris’s World War II story, “The Tattooist of Auschwitz.”',
    uuid: '00000000-0000-0000-0000-000000000000',
    uri: 'nyt://book/00000000-0000-0000-0000-000000000000',
    isbn13: [ '9780062797155' ] } ]

C:\Users\jacob\Coding\nytimes-api>node index
[ { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 1,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'http://www.amazon.com/Atlas-Obscura-Explorers-Worlds-Wonders/dp/0761169083?tag=NYTBS-20',
    isbns: [ [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 2,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'http://www.amazon.com/Humans-New-York-Brandon-Stanton/dp/1250058902?tag=NYTBS-20',
    isbns: [ [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 3,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'http://www.amazon.com/The-Road-Little-Dribbling-Adventures-ebook/dp/B00X2F7N3M?tag=NYTBS-20',
    isbns: [ [Object], [Object], [Object], [Object], [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 4,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'http://www.amazon.com/Humans-New-York-Brandon-Stanton/dp/1250038820?tag=NYTBS-20',
    isbns: [ [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 5,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'http://www.amazon.com/Highest-Duty-Search-Really-Matters/dp/0061924695?tag=NYTBS-20',
    isbns: [ [Object], [Object], [Object], [Object], [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 6,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'http://www.amazon.com/Destinations-Lifetime-Worlds-Amazing-Places/dp/1426215649?tag=NYTBS-20',
    isbns: [ [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 7,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'https://www.amazon.com/Speaking-American-Youse-Visual-Guide/dp/0544703391?tag=NYTBS-20',
    isbns: [ [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 8,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'http://www.amazon.com/Wild-Found-Pacific-Crest-Trail/dp/0307476073?tag=NYTBS-20',
    isbns:
     [ [Object], [Object], [Object], [Object], [Object], [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 9,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'https://www.amazon.com/Lion-Movie-Tie-Saroo-Brierley/dp/0399584692?tag=NYTBS-20',
    isbns: [ [Object], [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] },
  { list_name: 'Travel',
    display_name: 'Travel',
    bestsellers_date: '2016-12-31',
    published_date: '2017-01-15',
    rank: 10,
    rank_last_week: 0,
    weeks_on_list: 0,
    asterisk: 0,
    dagger: 0,
    amazon_product_url:
     'https://www.amazon.com/Nonstop-Metropolis-York-City-Atlas/dp/0520285956?tag=NYTBS-20',
    isbns: [ [Object], [Object] ],
    book_details: [ [Object] ],
    reviews: [ [Object] ] } ]

C:\Users\jacob\Coding\nytimes-api>node index
{ bestsellers_date: '2019-02-16',
  published_date: '2019-03-03',
  published_date_description: 'latest',
  previous_published_date: '2019-02-24',
  next_published_date: '',
  lists:
   [ { list_id: 704,
       list_name: 'Combined Print and E-Book Fiction',
       list_name_encoded: 'combined-print-and-e-book-fiction',
       display_name: 'Combined Print & E-Book Fiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780735219090.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] },
     { list_id: 708,
       list_name: 'Combined Print and E-Book Nonfiction',
       list_name_encoded: 'combined-print-and-e-book-nonfiction',
       display_name: 'Combined Print & E-Book Nonfiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781524763138.jpg',
       list_image_width: 326,
       list_image_height: 495,
       books: [Array] },
     { list_id: 1,
       list_name: 'Hardcover Fiction',
       list_name_encoded: 'hardcover-fiction',
       display_name: 'Hardcover Fiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780735219090.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] },
     { list_id: 2,
       list_name: 'Hardcover Nonfiction',
       list_name_encoded: 'hardcover-nonfiction',
       display_name: 'Hardcover Nonfiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781524763138.jpg',
       list_image_width: 326,
       list_image_height: 495,
       books: [Array] },
     { list_id: 17,
       list_name: 'Trade Fiction Paperback',
       list_name_encoded: 'trade-fiction-paperback',
       display_name: 'Paperback Trade Fiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780062797155.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] },
     { list_id: 4,
       list_name: 'Paperback Nonfiction',
       list_name_encoded: 'paperback-nonfiction',
       display_name: 'Paperback Nonfiction',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780062316097.jpg',
       list_image_width: 128,
       list_image_height: 192,
       books: [Array] },
     { list_id: 24,
       list_name: 'Advice How-To and Miscellaneous',
       list_name_encoded: 'advice-how-to-and-miscellaneous',
       display_name: 'Advice, How-To & Miscellaneous',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781400201655.jpg',
       list_image_width: 325,
       list_image_height: 495,
       books: [Array] },
     { list_id: 13,
       list_name: 'Childrens Middle Grade Hardcover',
       list_name_encoded: 'childrens-middle-grade-hardcover',
       display_name: 'Children’s Middle Grade Hardcover',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780375899881.jpg',
       list_image_width: 329,
       list_image_height: 495,
       books: [Array] },
     { list_id: 7,
       list_name: 'Picture Books',
       list_name_encoded: 'picture-books',
       display_name: 'Children’s Picture Books',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780448489322.jpg',
       list_image_width: 330,
       list_image_height: 403,
       books: [Array] },
     { list_id: 10,
       list_name: 'Series Books',
       list_name_encoded: 'series-books',
       display_name: 'Children’s Series',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780545935210.jpg',
       list_image_width: 330,
       list_image_height: 488,
       books: [Array] },
     { list_id: 14,
       list_name: 'Young Adult Hardcover',
       list_name_encoded: 'young-adult-hardcover',
       display_name: 'Young Adult Hardcover',
       updated: 'WEEKLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780062498564.jpg',
       list_image_width: 329,
       list_image_height: 499,
       books: [Array] },
     { list_id: 301,
       list_name: 'Audio Fiction',
       list_name_encoded: 'audio-fiction',
       display_name: 'Audio Fiction',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780735219090.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] },
     { list_id: 302,
       list_name: 'Audio Nonfiction',
       list_name_encoded: 'audio-nonfiction',
       display_name: 'Audio Nonfiction',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781524763138.jpg',
       list_image_width: 326,
       list_image_height: 495,
       books: [Array] },
     { list_id: 532,
       list_name: 'Business Books',
       list_name_encoded: 'business-books',
       display_name: 'Business',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781524731663.jpg',
       list_image_width: 330,
       list_image_height: 493,
       books: [Array] },
     { list_id: 531,
       list_name: 'Science',
       list_name_encoded: 'science',
       display_name: 'Science',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9780062316097.jpg',
       list_image_width: 128,
       list_image_height: 192,
       books: [Array] },
     { list_id: 538,
       list_name: 'Sports',
       list_name_encoded: 'sports',
       display_name: 'Sports and Fitness',
       updated: 'MONTHLY',
       list_image: 'https://s1.nyt.com/du/books/images/9781501135934.jpg',
       list_image_width: 328,
       list_image_height: 495,
       books: [Array] } ] }