Best Seller List by Date

GET {{baseUrl}}/lists/:date/{{list}}.json?isbn=<string>&list-name=<string>&published-date=<string>&bestsellers-date=<string>&weeks-on-list=<integer>&rank=<integer>&rank-last-week=<integer>&offset=<integer>&sort-order=<string>

Request Params

KeyDatatypeRequiredDescription
isbnstringInternational Standard Book Number, 10 or 13 digits
list-namestringThe name of the Times best-seller list. To get valid values, use a list names request.nnBe 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-datestringYYYY-MM-DDnnThe date the best-seller list was published on NYTimes.com (compare bestsellers-date)
bestsellers-datestringYYYY-MM-DDnnThe 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-liststringThe number of weeks that the best seller has been on list-name, as of bestsellers-date
rankstringThe rank of the best seller on list-name as of bestsellers-date
rank-last-weekstringThe rank of the best seller on list-name one week prior to bestsellers-date
offsetstringSets the starting point of the result set
sort-orderstringSets the sort order of the result set