The New York Times Company
The New York Times Company (NYSE: NYT) is the publisher of The New York Times and operator of a portfolio of news, product-review, sports, cooking, and games products including The Athletic, Wirecutter, Wordle, NYT Cooking, and NYT Games. The company also runs a public developer program at developer.nytimes.com that exposes a family of read-only REST APIs over its newsroom content: article search, top stories, most popular, archive going back to 1851, best-seller and book-review lists, movie reviews, the Times Newswire firehose, the controlled vocabulary that powers Times Topics (TimesTags), the Semantic API, and a Geographic API that pairs Times geo-tagged content with the GeoNames database. All APIs share api.nytimes.com as the host, use a query-string api-key for authentication, and respond as JSON.
APIs
Article Search API
Look up New York Times articles by keyword. Supports filtering with Lucene-style filter queries (fq=...) against an Elasticsearch-backed index, facets, date range filters, and p...
Top Stories API
Returns an array of articles currently on a specified NYTimes.com section (or the homepage). 26 sections are supported including arts, business, opinion, politics, science, spor...
Most Popular API
Returns the most emailed, most shared (Facebook), and most viewed articles on NYTimes.com for the last 1, 7, or 30 days.
Times Newswire API
An up-to-the-minute stream of metadata and links for articles as soon as they are published on NYTimes.com. Can be filtered by source (all, nyt, iht) and one or more sections.
Archive API
Returns an array of NYT articles for a given month, going back to 1851. Response fields mirror the Article Search API. Useful for bulk-loading article metadata locally. Response...
Books API
Provides information about NYT book reviews and The New York Times Best Sellers lists. Some lists are weekly and some monthly. Supports current and historical date lookups, list...
Movie Reviews API
Search NYT movie reviews by keyword, filter by Critics' Picks, and retrieve metadata about Times movie critics.
TimesTags API
Auto-suggest service over the New York Times controlled vocabulary used to build Times Topics pages (approximately 27,000 tags: 3,000 Descriptors, 1,500 Geographic, 7,500 Organi...
Semantic API
Complements Article Search by exposing the full controlled vocabulary of over 100,000 people, places, organizations, and descriptors used as metadata by The New York Times since...
Geographic API
Linked-data extension of the Semantic API that pairs the location concepts in the Times controlled vocabulary with the GeoNames database, returning a normalized record for place...
Community API (Deprecated)
Get access to comments from registered users on New York Times articles. Marked deprecated by NYT; a replacement was in progress at the time the spec was published. Documented h...