The New York Times Company · Example Payload

Books Best Sellers List Example

NewsMediaPublishingNewspapersArticlesBooksMoviesSportsGamesCookingReviewsSearchSemanticTaggingControlled VocabularyGeographicArchive

Books Best Sellers List Example is an example object payload from The New York Times Company, with 5 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

statuscopyrightnum_resultslast_modifiedresults

Example Payload

Raw ↑ 
{
  "status": "OK",
  "copyright": "Copyright (c) 2026 The New York Times Company. All Rights Reserved.",
  "num_results": 15,
  "last_modified": "2026-05-22T00:00:00-04:00",
  "results": {
    "list_name": "Hardcover Fiction",
    "list_name_encoded": "hardcover-fiction",
    "bestsellers_date": "2026-05-17",
    "published_date": "2026-05-25",
    "published_date_description": "latest",
    "next_published_date": "2026-06-01",
    "previous_published_date": "2026-05-18",
    "display_name": "Hardcover Fiction",
    "normal_list_ends_at": 15,
    "updated": "WEEKLY",
    "books": [
      {
        "rank": 1,
        "rank_last_week": 2,
        "weeks_on_list": 5,
        "asterisk": 0,
        "dagger": 0,
        "primary_isbn10": "1234567890",
        "primary_isbn13": "9781234567890",
        "publisher": "Knopf",
        "description": "A sweeping multigenerational saga set in coastal Maine.",
        "price": "0.00",
        "title": "THE TIDES OF PEMAQUID",
        "author": "Author Name",
        "contributor": "by Author Name",
        "contributor_note": "",
        "book_image": "https://storage.googleapis.com/du-prd/books/images/9781234567890.jpg",
        "amazon_product_url": "https://www.amazon.com/dp/1234567890",
        "buy_links": [
          {"name": "Amazon", "url": "https://www.amazon.com/dp/1234567890"},
          {"name": "Apple Books", "url": "https://goto.applebooks.apple/9781234567890"},
          {"name": "Barnes and Noble", "url": "https://www.barnesandnoble.com/w/9781234567890"}
        ]
      }
    ]
  }
}