Best Seller List

GET {{baseUrl}}/lists.{{format}}

Get Best Sellers list. If no date is provided returns the latest list.

Request Params

KeyDatatypeRequiredDescription
liststringThe name of the Times best-seller list. To get valid values, use a list names request.

Be sure to replace spaces with hyphens (e.g., e-book-fiction or hardcover-fiction, not E-Book Fiction or Hardcover Fiction). (The parameter is not case sensitive.) | | weeks-on-list | string | | The number of weeks that the best seller has been on list-name, as of bestsellers-date | | bestsellers-date | string | | YYYY-MM-DD

The week-ending date for the sales reflected on list-name. Times best-seller lists are compiled using available book sale data. The bestsellers-date may be significantly earlier than published-date. For additional information, see the explanation at the bottom of any best-seller list page on NYTimes.com (example: Hardcover Fiction, published Dec. 5 but reflecting sales to Nov. 29). | | date | string | | YYYY-MM-DD The date the best-seller list was published on NYTimes.com (compare bestsellers-date) | | isbn | string | | International Standard Book Number, 10 or 13 digits | | published-date | string | | YYYY-MM-DD

The date the best-seller list was published on NYTimes.com (compare bestsellers-date) | | rank | string | | The rank of the best seller on list-name as of bestsellers-date | | rank-last-week | string | | The rank of the best seller on list-name one week prior to bestsellers-date | | offset | string | | Sets the starting point of the result set | | sort-order | string | | Sets the sort order of the result set |

RESPONSES

status: OK

{"copyright":"Copyright (c) 2016 The New York Times Company.  All Rights Reserved.","last_modified":"2016-03-11T13:09:01-05:00","num_results":1,"results":[{"amazon_product_url":"http://www.amazon.com/Girls-Guide-Moving-On-Novel-ebook/dp/B00ZNE17B4?tag=thenewyorktim-20","asterisk":0,"bestsellers_date":"2016-03-05","book_details":[{"age_group":"","author":"Debbie Macomber","contributor":"by Debbie Macomber","contributor_note":"","description":"A mother and her daughter-in-law both leave unhappy marriages and take up with new men.","price":0,"primary_isbn10":"0553391925","primary_isbn13":"9780553391923","publisher":"Ballantine","title":"A GIRL'S GUIDE TO MOVING ON"}],"dagger":0,"display_name":"Hardcover Fiction","isbns":[{"isbn10":"0553391925","isbn13":"9780553391923"}],"list_name":"Hardcover Fiction","published_date":"2016-03-20","rank":5,"rank_last_week":2,"reviews":[{"article_chapter_link":"","book_review_link":"","first_chapter_link":"","sunday_review_link":""}],"weeks_on_list":2}],"status":"OK"}