nytimes-api
  • Welcome!
  • Documentation
    • Popular - mostEmailed
    • Popular - mostViewed
    • Popular - mostShared
    • Movies - allCritics
    • Movies - criticsPick
    • Movies - searchCritics
    • Movies - searchReviews
    • Books - bestSellersLists
    • Books - bestSellers
    • Books - overview
    • Books - searchReviews
    • TopStories - sections
    • TopStories - randomSection
    • TopStories - topStories
  • Examples
  • Changelogs
    • 1.0
    • 1.1
    • 1.2
    • 1.2.1
    • 1.3
Powered by GitBook
On this page
  • Example
  • What does it do?
  • Example Response
  1. Documentation

Books - bestSellers

Example

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

books.bestSellers('Travel', data => console.log(data));

What does it do?

bestSellers gets all of the books in a list of best sellers. You can specify any of the lists of best sellers given to you by bestSellersLists. The code example above gets all of the books in the Travel list.

Example Response

example-response.json
[ { 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] ] } ]
PreviousBooks - bestSellersListsNextBooks - overview

Last updated 6 years ago