Skip to main content

NytBooksSdk Python SDK 1.0.0

Welcome to the NytBooksSdk SDK documentation. This guide will help you get started with integrating and using the NytBooksSdk SDK in your project.

Versions

  • API version: 3.0.0
  • SDK version: 1.0.0

About the API

The Books API provides information about book reviews and The New York Times Best Sellers lists.

Best Sellers Lists Services

List Names

The lists/names service returns a list of all the NYT Best Sellers Lists. Some lists are published weekly and others monthly. The response includes when each list was first published and last published. /lists/names.json

List Data

The lists/{date}/{name} service returns the books on the best sellers list for the specified date and list name. /lists/2019-01-20/hardcover-fiction.json Use current for {date} to get the latest list. /lists/current/hardcover-fiction.json

Book Reviews Services

The book reviews service lets you get NYT book review by author, ISBN, or title. /reviews.json?author=Michelle+Obama /reviews.json?isbn=9781524763138 /reviews.json?title=Becoming Example Calls https://api.nytimes.com/svc/books/v3/lists/current/hardcover-fiction.json?api-key=yourkey https://api.nytimes.com/svc/books/v3/reviews.json?author=Stephen+King&api-key=yourkey

Table of Contents

Setup & Configuration

Supported Language Versions

This SDK is compatible with the following versions: Python >= 3.7

Installation

To get started with the SDK, we recommend installing using pip:

pip install nyt-books

Services

The SDK provides various services to interact with the API.

Below is a list of all available services with links to their detailed documentation:
Name
ListsJsonService
ListsService
ReviewsJsonService

Models

The SDK includes several models that represent the data structures used in API requests and responses. These models help in organizing and managing the data efficiently.

Below is a list of all available models with links to their detailed documentation:
Name Description
GetListsFormatOkResponse
GetListsDateListJsonOkResponse
OverviewResponse
GetListsNamesFormatOkResponse
GetListsBestSellersHistoryJsonOkResponse
GetReviewsFormatOkResponse
GetListsFormatOkResponseResults
ResultsIsbns_1
BookDetails
ResultsReviews_1
GetListsDateListJsonOkResponseResults
ResultsBooks
BooksIsbns
BooksBuyLinks_1
Result
Lists
ListsBooks
BooksBuyLinks_2
GetListsNamesFormatOkResponseResults
Updated
GetListsBestSellersHistoryJsonOkResponseResults
ResultsIsbns_2
RanksHistory
ResultsReviews_2
GetReviewsFormatOkResponseResults

License

This SDK is licensed under the MIT License.

See the LICENSE file for more details.

Metadata

Release files for nyt-books 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nyt-books 1.0.0
File Size Uploaded Provenance Actions
nyt-books-1.0.0.tar.gz 22.8 kB Without provenance Details for nyt-books-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nyt-books 1.0.0
File Interpreter ABI Platform Actions
nyt_books-1.0.0-py3-none-any.whl Python 3 none any Details for nyt_books-1.0.0-py3-none-any.whl

Total release size: 62.7 kB

Release files / nyt-books-1.0.0.tar.gz

Download URL nyt-books-1.0.0.tar.gz
Size 22.8 kB
Tags Source
SHA-256 checksum
How to use checksums
860ad460b844587088f6a87dbdbf17aad3cf228f7d1a91396ec70717414a8140
BLAKE2b-256 checksum
How to use checksums
8e98d5ad7d5c62f2908d95bd5ea7b9e1cd2dab04021f15bee18d91007a18231a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.17

Release files / nyt_books-1.0.0-py3-none-any.whl

Download URL nyt_books-1.0.0-py3-none-any.whl
Size 39.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5db6fd95692f21adc6ba9a6bfce09662aca566c057745527e3318169760eebbf
BLAKE2b-256 checksum
How to use checksums
b0dda6937dbe7ea89f0336d1ebe440ce74c167bc0ac543b0f1ef73d426d14b13
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.17

Security for nyt-books 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page