v5

latestSwagger 2.0raw.githubusercontent.com2016-08-256064.5 KB

Best Seller List by Date

get/lists/{date}/{list}.json

Query parameters

isbninteger

International Standard Book Number, 10 or 13 digits

list-namestring

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-datestring date-time

YYYY-MM-DD

The date the best-seller list was published on NYTimes.com (compare bestsellers-date)

bestsellers-datestring

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-listinteger

The number of weeks that the best seller has been on list-name, as of bestsellers-date

rankstring

The rank of the best seller on list-name as of bestsellers-date

rank-last-weekinteger

The rank of the best seller on list-name one week prior to bestsellers-date

offsetinteger

Sets the starting point of the result set

sort-order'ASC' | 'DESC'

The default is ASC (ascending). The sort-order parameter is used with the sort-by parameter — for details, see each request type.

Response

statusstring

copyrightstring

num_resultsinteger

last_modifiedstring