# The New York Times API

> 3 public methods for The New York Times (nytimes.com), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by The New York Times.

- Page: https://fous.com/methods/nytimes.com

## Methods

### [List New York Times Best Sellers](https://fous.com/methods/nytimes.com/list-best-sellers.md)

`nytimes.com/list_best_sellers`, read. Gets a New York Times Best Sellers list by its name for the latest issue, or for the issue covering a given date. Monthly lists use their issue month.

Returns: list name, published date, books with rank, last week's rank, weeks on list, title, author, publisher, description, cover image, ISBN-13, buy links, review link, page link

### [List headlines](https://fous.com/methods/nytimes.com/list-headlines.md)

`nytimes.com/list_headlines`, read. Lists current New York Times headlines with summaries, authors, images and publication times, in the order shown on the chosen section page (top stories or a section). Video-only items, ads and promotions are left out; times come from the section's feed and may be missing.

Returns: stories (headline, summary, published time, authors, section, image, article link)

### [Search articles](https://fous.com/methods/nytimes.com/search-news.md)

`nytimes.com/search_news`, read. Searches New York Times article headlines and summaries by keyword, optionally within a date range, and returns matching articles with dates, authors, sections and links, newest or most relevant first.

Returns: headline, summary, published date, authors, section, article link