---
title: "Best Seller List"
method: GET
path: "/lists.{format}"
---

# Best Seller List

`GET /lists.{format}`

## Query parameters

- `list` string
- `weeks-on-list` integer
- `bestsellers-date` string, date-time
- `date` string
- `isbn` string
- `published-date` string
- `rank` integer
- `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
    - `display_name` string
    - `bestsellers_date` string
    - `published_date` string
    - `rank` integer
    - `rank_last_week` integer
    - `weeks_on_list` integer
    - `asterisk` integer
    - `dagger` integer
    - `amazon_product_url` string
    - `isbns` object[]
      - `isbn10` string
      - `isbn13` string
    - `book_details` object[]
      - `title` string
      - `description` string
      - `contributor` string
      - `author` string
      - `contributor_note` string
      - `price` integer
      - `age_group` string
      - `publisher` string
      - `primary_isbn13` string
      - `primary_isbn10` string
    - `reviews` object[]
      - `book_review_link` string
      - `first_chapter_link` string
      - `sunday_review_link` string
      - `article_chapter_link` string

---

[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)