Best Seller List

GET {{baseUrl}}/lists.{{format}}?list=hardcover-fiction

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

Request Params

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

{"status":"OK","copyright":"Copyright (c) 2021 The New York Times Company.  All Rights Reserved.","num_results":15,"last_modified":"2021-10-06T22:12:45-04:00","results":[{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":1,"rank_last_week":0,"weeks_on_list":1,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/1538728621?tag=NYTBSREV-20","isbns":[{"isbn10":"1538728621","isbn13":"9781538728628"}],"book_details":[{"title":"THE WISH","description":"Maggie Dawes, a renowned travel photographer, struggles with a medical diagnosis over Christmas.","contributor":"by Nicholas Sparks","author":"Nicholas Sparks","contributor_note":"","price":"0.00","age_group":"","publisher":"Grand Central","primary_isbn13":"9781538728628","primary_isbn10":"1538728621"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":2,"rank_last_week":0,"weeks_on_list":1,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/1982168439?tag=NYTBSREV-20","isbns":[{"isbn10":"1982168439","isbn13":"9781982168438"},{"isbn10":"1982168455","isbn13":"9781982168452"}],"book_details":[{"title":"CLOUD CUCKOO LAND","description":"An interconnected cast of dreamers and outsiders are in dangerous and disparate settings past, present and future.","contributor":"by Anthony Doerr","author":"Anthony Doerr","contributor_note":"","price":"0.00","age_group":"","publisher":"Scribner","primary_isbn13":"9781982168438","primary_isbn10":"1982168439"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":3,"rank_last_week":1,"weeks_on_list":3,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/1250220254?tag=NYTBSREV-20","isbns":[{"isbn10":"1250220254","isbn13":"9781250220257"},{"isbn10":"1250220262","isbn13":"9781250220264"},{"isbn10":"1250810698","isbn13":"9781250810694"}],"book_details":[{"title":"APPLES NEVER FALL","description":"The Delaney siblings suspect their father of causing the disappearance of their mother.","contributor":"by Liane Moriarty","author":"Liane Moriarty","contributor_note":"","price":"0.00","age_group":"","publisher":"Holt","primary_isbn13":"9781250220257","primary_isbn10":"1250220254"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":4,"rank_last_week":3,"weeks_on_list":3,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/0385545134?tag=NYTBSREV-20","isbns":[{"isbn10":"0385545134","isbn13":"9780385545136"},{"isbn10":"0385545142","isbn13":"9780385545143"}],"book_details":[{"title":"HARLEM SHUFFLE","description":"Ray Carney, a family man who sells furniture on 125th Street, gets a new clientele made up of vicious and unsavory characters.","contributor":"by Colson Whitehead","author":"Colson Whitehead","contributor_note":"","price":"0.00","age_group":"","publisher":"Doubleday","primary_isbn13":"9780385545136","primary_isbn10":"0385545134"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":5,"rank_last_week":0,"weeks_on_list":1,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/0593128869?tag=NYTBSREV-20","isbns":[{"isbn10":"0593128869","isbn13":"9780593128862"},{"isbn10":"0593128877","isbn13":"9780593128879"}],"book_details":[{"title":"THE LAST GRADUATE","description":"The second book in the Scholomance series. Will students now in their senior year make it out alive?","contributor":"by Naomi Novik","author":"Naomi Novik","contributor_note":"","price":"0.00","age_group":"","publisher":"Del Rey","primary_isbn13":"9780593128862","primary_isbn10":"0593128869"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":6,"rank_last_week":2,"weeks_on_list":2,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/0316276626?tag=NYTBSREV-20","isbns":[{"isbn10":"0316276626","isbn13":"9780316276627"},{"isbn10":"0316280011","isbn13":"9780316280013"}],"book_details":[{"title":"THE JAILHOUSE LAWYER","description":"A young lawyer winds up in an Alabama jail that remains mysteriously crowded.","contributor":"by James Patterson and Nancy Allen","author":"James Patterson and Nancy Allen","contributor_note":"","price":"0.00","age_group":"","publisher":"Little, Brown","primary_isbn13":"9780316276627","primary_isbn10":"0316276626"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":7,"rank_last_week":8,"weeks_on_list":2,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/0393881148?tag=NYTBSREV-20","isbns":[{"isbn10":"0393881148","isbn13":"9780393881141"}],"book_details":[{"title":"BEWILDERMENT","description":"An astrobiologist and single father learns of a neurofeedback treatment that may improve his son’s emotional control.","contributor":"by Richard Powers","author":"Richard Powers","contributor_note":"","price":"0.00","age_group":"","publisher":"Norton","primary_isbn13":"9780393881141","primary_isbn10":"0393881148"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":8,"rank_last_week":0,"weeks_on_list":1,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/1984880993?tag=NYTBSREV-20","isbns":[{"isbn10":"1984880993","isbn13":"9781984880994"},{"isbn10":"1984881000","isbn13":"9781984881007"}],"book_details":[{"title":"THE MAN WHO DIED TWICE","description":"The second book in the Thursday Murder Club series. A ruthless murderer is out to get four septuagenarian friends.","contributor":"by Richard Osman","author":"Richard Osman","contributor_note":"","price":"0.00","age_group":"","publisher":"Pamela Dorman","primary_isbn13":"9781984880994","primary_isbn10":"1984880993"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":9,"rank_last_week":5,"weeks_on_list":9,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/1982173610?tag=NYTBSREV-20","isbns":[{"isbn10":"1982173610","isbn13":"9781982173616"},{"isbn10":"1982173637","isbn13":"9781982173630"},{"isbn10":"179712269X","isbn13":"9781797122694"}],"book_details":[{"title":"BILLY SUMMERS","description":"A killer for hire who only takes out bad guys seeks redemption as he does one final job.","contributor":"by Stephen King","author":"Stephen King","contributor_note":"","price":"0.00","age_group":"","publisher":"Scribner","primary_isbn13":"9781982173616","primary_isbn10":"1982173610"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":10,"rank_last_week":0,"weeks_on_list":1,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/1250279313?tag=NYTBSREV-20","isbns":[{"isbn10":"1250279313","isbn13":"9781250279316"},{"isbn10":"1250279321","isbn13":"9781250279323"}],"book_details":[{"title":"THE SANTA SUIT","description":"A recently divorced woman searching the pockets of an old Santa suit finds a child’s wish that her father return from war.","contributor":"by Mary Kay Andrews","author":"Mary Kay Andrews","contributor_note":"","price":"0.00","age_group":"","publisher":"St. Martin's","primary_isbn13":"9781250279316","primary_isbn10":"1250279313"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":11,"rank_last_week":9,"weeks_on_list":22,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/1501171348?tag=NYTBSREV-20","isbns":[{"isbn10":"1501171348","isbn13":"9781501171345"},{"isbn10":"1501171364","isbn13":"9781501171369"},{"isbn10":"1797124749","isbn13":"9781797124742"}],"book_details":[{"title":"THE LAST THING HE TOLD ME","description":"Hannah Hall discovers truths about her missing husband and bonds with his daughter from a previous relationship.","contributor":"by Laura Dave","author":"Laura Dave","contributor_note":"","price":"0.00","age_group":"","publisher":"Simon \u0026 Schuster","primary_isbn13":"9781501171345","primary_isbn10":"1501171348"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":12,"rank_last_week":7,"weeks_on_list":4,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/0374602603?tag=NYTBSREV-20","isbns":[{"isbn10":"0374602603","isbn13":"9780374602604"},{"isbn10":"0374602611","isbn13":"9780374602611"}],"book_details":[{"title":"BEAUTIFUL WORLD, WHERE ARE YOU","description":"A novelist, a warehouse worker, an editorial assistant and a political adviser deal with changes.","contributor":"by Sally Rooney","author":"Sally Rooney","contributor_note":"","price":"0.00","age_group":"","publisher":"Farrar, Straus \u0026 Giroux","primary_isbn13":"9780374602604","primary_isbn10":"0374602603"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":13,"rank_last_week":6,"weeks_on_list":3,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/1982164883?tag=NYTBSREV-20","isbns":[{"isbn10":"1982164883","isbn13":"9781982164881"},{"isbn10":"1982164905","isbn13":"9781982164904"},{"isbn10":"1797128256","isbn13":"9781797128252"}],"book_details":[{"title":"VINCE FLYNN: ENEMY AT THE GATES","description":"Anthony Cook, an autocratic president, distrusts Mitch Rapp, who is working to uncover a traitor.","contributor":"by Kyle Mills","author":"Kyle Mills","contributor_note":"","price":"0.00","age_group":"","publisher":"Emily Bestler/Atria","primary_isbn13":"9781982164881","primary_isbn10":"1982164883"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":14,"rank_last_week":12,"weeks_on_list":44,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/0525559477?tag=NYTBSREV-20","isbns":[{"isbn10":"0525559477","isbn13":"9780525559474"},{"isbn10":"0525559485","isbn13":"9780525559481"},{"isbn10":"0655697071","isbn13":"9780655697077"}],"book_details":[{"title":"THE MIDNIGHT LIBRARY","description":"Nora Seed finds a library beyond the edge of the universe that contains books with multiple possibilities of the lives one could have lived.","contributor":"by Matt Haig","author":"Matt Haig","contributor_note":"","price":"0.00","age_group":"","publisher":"Viking","primary_isbn13":"9780525559474","primary_isbn10":"0525559477"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]},{"list_name":"Hardcover Fiction","display_name":"Hardcover Fiction","bestsellers_date":"2021-10-02","published_date":"2021-10-17","rank":15,"rank_last_week":11,"weeks_on_list":5,"asterisk":0,"dagger":0,"amazon_product_url":"https://www.amazon.com/dp/073521123X?tag=NYTBSREV-20","isbns":[{"isbn10":"073521123X","isbn13":"9780735211230"},{"isbn10":"0735211256","isbn13":"9780735211254"},{"isbn10":"0593453166","isbn13":"9780593453162"},{"isbn10":"0593453158","isbn13":"9780593453155"}],"book_details":[{"title":"A SLOW FIRE BURNING","description":"Three women come under scrutiny when a young man is found gruesomely murdered in a London houseboat.","contributor":"by Paula Hawkins","author":"Paula Hawkins","contributor_note":"","price":"0.00","age_group":"","publisher":"Riverhead","primary_isbn13":"9780735211230","primary_isbn10":"073521123X"}],"reviews":[{"book_review_link":"","first_chapter_link":"","sunday_review_link":"","article_chapter_link":""}]}]}