Nytimes APIs
12 APIs33 Endpoints2 Categories
Categories
API Catalog(9 of 12)
Books API
The New York Times Books API provides programmatic access to NYT Best Sellers lists and book reviews. Agents can retrieve current and historical best seller rankings across more than 50 list categories (hardcover fiction, nonfiction, children's, advice, graphic novels), look up an individual title's appearance history, and pull reviews written by NYT critics. Results include ISBNs, author names, publishers, weeks-on-list counts, and Amazon product URLs, making the data immediately usable for book recommendation and discovery experiences.
6 endpointsBooks API
This NYT Books spec is a third-party Konfig-sourced bundle that mirrors the NYT Books service with one extra endpoint, /lists/full-overview.json, returning the complete entries across every active Best Sellers list rather than just the top five. The 7 GET endpoints provide programmatic access to NYT Best Sellers rankings (current and historical), the catalogue of available list names, individual book ranking history by ISBN or author, and NYT critic book reviews. Responses include ISBN-13, weeks-on-list, rank-last-week, publisher, and Amazon product URLs.
7 endpointsCommunity API
The New York Times Community API provides read access to comments left by registered users on NYT articles. Agents can pull recent comments site-wide, filter by article URL, retrieve a specific user's comment history, or fetch comments posted within a date range. Each comment record includes the author's display name, comment body, recommendation count, NYT pick flag, and the article URL it was posted on. The API is officially marked deprecated by NYT, but the endpoints continue to respond and remain useful for archival research and sentiment analysis on legacy NYT comment threads.
Connect Your Agent
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.