---
title: "Best Seller List by Date"
method: GET
path: "/lists/{date}/{list}.json"
---

# Best Seller List by Date

`GET /lists/{date}/{list}.json`

## Query parameters

- `isbn` integer
- `list-name` string
- `published-date` string, date-time
- `bestsellers-date` string
- `weeks-on-list` integer
- `rank` string
- `rank-last-week` integer
- `offset` integer
- `sort-order` 'ASC' | 'DESC'

## Response `200`

OK

- object
  - `status` string
  - `copyright` string
  - `num_results` integer
  - `last_modified` string
  - `results` object
    - `list_name` string
    - `bestsellers_date` string
    - `published_date` string
    - `display_name` string
    - `normal_list_ends_at` integer
    - `updated` string
    - `books` object[]
      - `rank` integer
      - `rank_last_week` integer
      - `weeks_on_list` integer
      - `asterisk` integer
      - `dagger` integer
      - `primary_isbn10` string
      - `primary_isbn13` string
      - `publisher` string
      - `description` string
      - `price` integer
      - `title` string
      - `author` string
      - `contributor` string
      - `contributor_note` string
      - `book_image` string
      - `amazon_product_url` string
      - `age_group` string
      - `book_review_link` string
      - `first_chapter_link` string
      - `sunday_review_link` string
      - `article_chapter_link` string
      - `isbns` object[]
        - `isbn10` string
        - `isbn13` string
    - `corrections` object[]

---

[API](https://skmtc.net/nytimes/apis/books-api.md) · [All operations](https://skmtc.net/nytimes/apis/books-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nytimes/books-api/revisions/b3e71a669113/schema)