The New York Times · Schema

NYT Best Seller Book

A book appearing on an NYT Best Sellers list.

ArticlesBooksMoviesNewsMediaPublishingJournalism

Properties

Name Type Description
title string Title of the book.
author string Primary author of the book.
contributor string All contributors to the book including author and illustrator.
contributor_note string Additional notes on contributions.
publisher string Standardized publisher name.
description string Brief description of the book.
price number Publisher's list price including decimal point.
age_group string Target age group for the book.
isbns array ISBN-10 and ISBN-13 identifiers for the book.
ranks_history array Historical ranking data across Best Sellers lists.
reviews array Links to NYT reviews of the book.
View JSON Schema on GitHub

JSON Schema

new-york-times-book-schema.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/the-new-york-times/main/json-schema/new-york-times-book-schema.json",
  "title": "NYT Best Seller Book",
  "description": "A book appearing on an NYT Best Sellers list.",
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Title of the book."
    },
    "author": {
      "type": "string",
      "description": "Primary author of the book."
    },
    "contributor": {
      "type": "string",
      "description": "All contributors to the book including author and illustrator."
    },
    "contributor_note": {
      "type": "string",
      "description": "Additional notes on contributions."
    },
    "publisher": {
      "type": "string",
      "description": "Standardized publisher name."
    },
    "description": {
      "type": "string",
      "description": "Brief description of the book."
    },
    "price": {
      "type": "number",
      "description": "Publisher's list price including decimal point."
    },
    "age_group": {
      "type": "string",
      "description": "Target age group for the book."
    },
    "isbns": {
      "type": "array",
      "description": "ISBN-10 and ISBN-13 identifiers for the book.",
      "items": {
        "type": "object",
        "properties": {
          "isbn10": {
            "type": "string",
            "description": "10-digit ISBN.",
            "pattern": "^[0-9X]{10}$"
          },
          "isbn13": {
            "type": "string",
            "description": "13-digit ISBN.",
            "pattern": "^[0-9]{13}$"
          }
        }
      }
    },
    "ranks_history": {
      "type": "array",
      "description": "Historical ranking data across Best Sellers lists.",
      "items": {
        "type": "object",
        "properties": {
          "list_name": {
            "type": "string",
            "description": "Internal name of the Best Sellers list."
          },
          "display_name": {
            "type": "string",
            "description": "Display name of the Best Sellers list."
          },
          "bestsellers_date": {
            "type": "string",
            "format": "date",
            "description": "Week-ending date for the sales data."
          },
          "published_date": {
            "type": "string",
            "format": "date",
            "description": "Date the list was published on NYTimes.com."
          },
          "rank": {
            "type": "integer",
            "description": "Ranking on the list."
          },
          "weeks_on_list": {
            "type": "integer",
            "description": "Total weeks on the list."
          }
        }
      }
    },
    "reviews": {
      "type": "array",
      "description": "Links to NYT reviews of the book.",
      "items": {
        "type": "object",
        "properties": {
          "book_review_link": {
            "type": "string",
            "format": "uri",
            "description": "Link to the full book review."
          },
          "article_chapter_link": {
            "type": "string",
            "format": "uri",
            "description": "Link to a related article or chapter."
          },
          "first_chapter_link": {
            "type": "string",
            "format": "uri",
            "description": "Link to a first chapter excerpt."
          },
          "sunday_review_link": {
            "type": "string",
            "format": "uri",
            "description": "Link to a Sunday Book Review item."
          }
        }
      }
    }
  },
  "required": ["title", "author"],
  "additionalProperties": true
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/new-york-times-book"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

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

Get an API key

Free tier, no email required.

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