New York Times Books API (Best Sellers)
The New York Times
The New York Times best-seller lists, week by week and list by list, through a free key.
The Books API returns the Times's weekly best-seller lists (hardcover and paperback fiction and nonfiction, advice, children's, and more), each title's rank and weeks on list, ISBNs, and links to Times reviews. One record is a book's appearance on a list in a given week.
Access
- Cost
- FreeFree API key from the NYT developer portal, with daily and per-minute call limits.
- License
- Provider's own termsNYT APIs Terms of Use
- Sign-up
- Free account
- How you get it
- APIJSON
What's in it
- One row is
- One row per book per list per week
- Covers
- United States
- Years
- 2008-present via the API
- Updated
- Weekly
- Size
- Not stated
Quality
Clean and authoritative for the lists themselves, but the lists are editorially compiled rankings, not sales figures.
- Ranks only, no sales counts
- List categories have been added and dropped over time
- Pre-2008 lists are not in the API
Connects to
- Open Library Data Dumps: Join on ISBN for subjects, editions, and page counts
- UCSD Goodreads Datasets: Compare best-seller status with reader ratings
Questions it could answer
- How long do debut novels stay on the hardcover fiction list compared with established authors?
- Which publishers hold the most best-seller weeks each year?