New York Times
App · News · 4 actions
Search New York Times articles, get top stories and trending articles, and look up the current Best Sellers list.
Actions
| Action | What it does |
|---|---|
| Get bestsellers | Get the current New York Times Best Sellers list for a category. |
| Get most popular articles | Get the most-viewed New York Times articles over the past 1, 7, or 30 days. |
| Get top stories | Get the current top stories for a New York Times section. |
| Search articles | Search New York Times articles by keyword, optionally within a date range. |
Get bestsellers
Get the current New York Times Best Sellers list for a category.
Inputs
- List name
list_nametextRequired - Best Sellers list to fetch, for example 'hardcover-fiction' or 'hardcover-nonfiction'. See the docs for the full list of names.
Outputs
bookslist- Books on the list, in rank order
Example output
{
"books": [
{
"author": "Sam Author",
"description": "A sweeping, ambitious debut.",
"publisher": "Example Publisher",
"purchase_url": "https://www.amazon.com/example",
"rank": 1,
"title": "EXAMPLE NOVEL",
"weeks_on_list": 3
}
]
}Get most popular articles
Get the most-viewed New York Times articles over the past 1, 7, or 30 days.
Inputs
- Period
periodnumber - Lookback window in days: 1, 7, or 30.One of:
1(Past day),7(Past week),30(Past month). Default:7.
Outputs
articleslist- Most-viewed articles in the period
Example output
{
"articles": [
{
"abstract": "A viral story about an unexpected topic.",
"byline": "By Alex Lee",
"published_date": "2026-01-18",
"title": "The Most-Read Story This Week",
"url": "https://www.nytimes.com/example.html"
}
]
}Get top stories
Get the current top stories for a New York Times section.
Inputs
- Section
sectiontextRequired - Section to fetch, for example 'home', 'world', or 'technology'.
Outputs
storieslist- Top stories in the section
Example output
{
"stories": [
{
"abstract": "Quarterly results beat expectations.",
"byline": "By John Doe",
"published_date": "2026-01-20T08:00:00-05:00",
"title": "Tech Giants Report Earnings",
"url": "https://www.nytimes.com/example.html"
}
]
}Search articles
Search New York Times articles by keyword, optionally within a date range.
Inputs
- Search query
qtextRequired - Keywords to search for.
- Begin date
begin_datetext - Only include articles published on or after this date (YYYYMMDD).
- End date
end_datetext - Only include articles published on or before this date (YYYYMMDD).
Outputs
articleslist- Matching articles
Example output
{
"articles": [
{
"abstract": "A look at urban adaptation efforts.",
"byline": "By Jane Smith",
"headline": "How Climate Change Is Reshaping Cities",
"pub_date": "2026-01-15T10:00:00Z",
"section_name": "Climate",
"web_url": "https://www.nytimes.com/example.html"
}
]
}