What’s Out There
← Back to swiping
Film, TV, & booksFreeCompany

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
list namepublished daterankweeks on listtitleauthorpublisherISBN

Quality

4 of 5

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

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?

Similar data sets

  • Circana BookScan

    Point-of-sale counts for about 85% of U.S. trade print book sales, the numbers publishers actually watch.

    Film, TV, & booksCircanaPaid

  • Netflix Top 10

    Netflix's own weekly rankings in about 93 countries since mid-2021, downloadable as spreadsheets.

    Film, TV, & booksNetflixFree

  • Seattle Public Library Checkouts by Title

    Monthly checkout counts for every book, ebook, DVD, and audiobook a big-city library lent since 2005.

    Film, TV, & booksSeattle Public Library (City of Seattle Open Data)Free

  • X (Twitter) API

    Once free for academics, Twitter data now costs credits per post read.

    Social mediaX Corp.Paid

  • Open Library Data Dumps

    A wiki-style catalog of tens of millions of book editions, dumped monthly for anyone to download.

    Film, TV, & booksInternet Archive (Open Library)Free

  • Social Blade

    Daily follower and view counts for millions of creators on YouTube, Twitch, Instagram, TikTok, and X.

    Social mediaSocial Blade LLCFree tier, paid upgrades