Best Seller History List
GET {{baseUrl}}/lists/best-sellers/history.json
Get Best Sellers list history.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
age-group | string | The target age group for the best seller. | |
author | string | The author of the best seller. The author field does not include additional contributors (see Data Structure for more details about the author and contributor fields). |
When searching the author field, you can specify any combination of first, middle and last names.
When sort-by is set to author, the results will be sorted by author's first name. |
| contributor | string | | The author of the best seller, as well as other contributors such as the illustrator (to search or sort by author name only, use author instead).
When searching, you can specify any combination of first, middle and last names of any of the contributors.
When sort-by is set to contributor, the results will be sorted by the first name of the first contributor listed. |
| isbn | string | | International Standard Book Number, 10 or 13 digits
A best seller may have both 10-digit and 13-digit ISBNs, and may have multiple ISBNs of each type. To search on multiple ISBNs, separate the ISBNs with semicolons (example: 9780446579933;0061374229). |
| price | string | | The publisher's list price of the best seller, including decimal point |
| publisher | string | | The standardized name of the publisher |
| title | string | | The title of the best seller
When searching, you can specify a portion of a title or a full title. |
RESPONSES
status: OK
{"copyright":"Copyright (c) 2016 The New York Times Company. All Rights Reserved.","num_results":28970,"results":[{"age_group":"","author":"Sophia Amoruso","contributor":"by Sophia Amoruso","contributor_note":"","description":"An online fashion retailer traces her path to success.","isbns":[{"isbn10":"039916927X","isbn13":"9780399169274"}],"price":0,"publisher":"Portfolio/Penguin/Putnam","ranks_history":[{"asterisk":0,"bestsellers_date":"2016-02-27","dagger":0,"display_name":"Business","list_name":"Business Books","primary_isbn10":"1591847931","primary_isbn13":"9781591847939","published_date":"2016-03-13","rank":8,"ranks_last_week":null,"weeks_on_list":0}],"reviews":[{"article_chapter_link":"","book_review_link":"","first_chapter_link":"","sunday_review_link":""}],"title":"#GIRLBOSS"}],"status":"OK"}