NYTimes Books is an API for accessing New York Times book-related information such as book reviews and bestseller data.

Provided free and as is, without warranty of any kind — including merchantability, fitness for a particular purpose, and the accuracy or completeness of any result. See the licence. You are responsible for checking what this produces before relying on it.

Nytimes Books

NYTimes Books is an API for accessing New York Times book-related information such as book reviews and bestseller data.

Base URL: https://api.nytimes.com/svc/books/v3
Auth: query:api-key (pass your key via the apiKey input)

Operations

get_lists_format — GET /lists.{format} — Best Seller List
get_lists_best_sellers_history_json — GET /lists/best-sellers/history.json — Best Seller History List
get_lists_names_format — GET /lists/names.{format} — Best Seller List Names
get_lists_overview_format — GET /lists/overview.{format} — Best Seller List Overview
get_lists_date_list_json — GET /lists/{date}/{list}.json — Best Seller List by Date
get_reviews_format — GET /reviews.{format} — Reviews

Inputs

apiKey — your nytimes-books API key
operation — one of the operations above
path parameters when an operation's path contains {...}
query — optional JSON object of query params
body — JSON object for create/update ops

Example

operation: get_lists_format
apiKey: <your key>

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

error
operation
result
status

Input Properties

Every property this tool accepts, from its own tool.iml.

Property	Type	Required	Default	Description
`apiKey`	string	yes	—	DEPRECATED — bind an API Key credential to the task with `credentialName` instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change.
`operation`	string	yes	—	One of: get_lists_format, get_lists_best_sellers_history_json, get_lists_names_format, get_lists_overview_format, get_lists_date_list_json, get_reviews_format
`date`	string	no	—	Path parameter date (required by some operations).
`format`	string	no	—	Path parameter format (required by some operations).
`list`	string	no	—	Path parameter list (required by some operations).
`query`	string	no	—	Optional query params as a JSON object string, e.g. {"limit": 10}.