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

{
  "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"}
        ]
      }
    ]
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/books-best-sellers-list-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.