Best Seller List by Date
GET {{baseUrl}}/lists/:date/{{list}}.json
Get Best Sellers list by date.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
isbn | string | International Standard Book Number, 10 or 13 digits | |
list-name | string | The 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.) |
| published-date | string | | YYYY-MM-DD
The date the best-seller list was published on NYTimes.com (compare 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). |
| weeks-on-list | string | | The number of weeks that the best seller has been on list-name, as of 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 | | The default is ASC (ascending). The sort-order parameter is used with the sort-by parameter — for details, see each request type. |
RESPONSES
status: OK
{"copyright":"Copyright (c) 2016 The New York Times Company. All Rights Reserved.","last_modified":"2015-12-25T13:05:20-05:00","num_results":15,"results":{"bestsellers_date":"2015-12-19","books":[{"age_group":"","amazon_product_url":"http://www.amazon.com/The-Martian-Novel-Andy-Weir-ebook/dp/B00EMXBDMA?tag=thenewyorktim-20","article_chapter_link":"","asterisk":0,"author":"Andy Weir","book_image":"http://du.ec2.nytimes.com.s3.amazonaws.com/prd/books/9780804139038.jpg","book_review_link":"","contributor":"by Andy Weir","contributor_note":"","dagger":0,"description":"Separated from his crew, an astronaut embarks on a quest to stay alive on Mars. The basis of the movie.","first_chapter_link":"","isbns":[{"isbn10":"0804139024","isbn13":"9780804139021"}],"price":0,"primary_isbn10":"0553418025","primary_isbn13":"9780553418026","publisher":"Broadway","rank":1,"rank_last_week":0,"sunday_review_link":"","title":"THE MARTIAN","weeks_on_list":60}],"corrections":[],"display_name":"Paperback Trade Fiction","list_name":"Trade Fiction Paperback","normal_list_ends_at":10,"published_date":"2016-01-03","updated":"WEEKLY"},"status":"OK"}