The New York Times
News headlines, article search results and best seller lists
The New York Times provides current section headlines and summaries, keyword-matched public listings with dates, authors, sections and links, and Best Sellers lists for the latest issue or dates within a week.
Your information
The list name in plain words, such as Hardcover Fiction or Young Adult Hardcover.
More options
Any day in the requested list week, for example 2025-03-25. Leave out for the latest issue.
Example results
Hardcover Fiction
Published Oct 4, 2026
Books
About the The New York Times tool
The New York Times (NYT) headline workflow reads a chosen section and returns headlines, summaries, authors, links, and available publication dates.
Search news finds article headlines and summaries matching required keywords, with optional date range, sorting, and page inputs.
List best sellers returns books for a required list name and the latest issue or a date within a week.
Built from nytimes.com. Last checked Sep 28, 2026.
Actions
List best sellers
1 creditGet a New York Times Best Sellers list by name for the latest issue or a date within a week. Monthly lists use their issue month.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Weekweek | Date | Optional | Any day in the requested list week, for example 2025-03-25. Leave out for the latest issue.Example: 2025-03-25 |
List Namelist_name | Text | Required | The list name in plain words, such as Hardcover Fiction or Young Adult Hardcover.Example: Hardcover Fiction |
What you get
| Field | Type | Description |
|---|---|---|
Booksbooks | List | |
Rankbooks[].rank | Number | Position on this list.Example: 1 |
Titlebooks[].title | Text | Example: DEAD BEAT |
Authorbooks[].author | Text | Example: Leigh Bardugo |
ISBN 13books[].isbn_13 | Text | Example: 9781250884312 |
Buy Linksbooks[].buy_links | List | |
Page Linkbooks[].page_link | Text | Link to this book on its Best Sellers page.Example: https://www.nytimes.com/books/best-sellers/2026/10/04/hardcover-fiction/#QmVzdF… |
Publisherbooks[].publisher | Text | Example: Flatiron |
Descriptionbooks[].description | Text | Example: The third book in the Ninth House series. Alex and her allies battle demons… |
Weeks On Listbooks[].weeks_on_list | Number | Number of issues on the list.Example: 1 |
Rank Last Weekbooks[].rank_last_week | Number | Rank on the preceding list, or null if not ranked then.Example: 6 |
Book Review Linkbooks[].book_review_link | Text | |
Cover Image Linkbooks[].cover_image_link | Text | Example: https://static01.nyt.com/bestsellers/images/9781250884312.jpg |
List Namelist_name | Text | Example: Hardcover Fiction |
Published Datepublished_date | Date | Example: 2026-10-04 |
Example result
For List Name: Hardcover Fiction
{
"books": [
{
"rank": 1,
"title": "DEAD BEAT",
"author": "Leigh Bardugo",
"isbn_13": "9781250884312",
"buy_links": [
{
"link": "https://www.amazon.com/dp/1250884314?tag=thenewyorktim-20",
"store_name": "Amazon"
},
{
"link": "https://goto.applebooks.apple/9781250884312?at=10lIEQ",
"store_name": "Apple Books"
}
],
"page_link": "https://www.nytimes.com/books/best-sellers/2026/10/04/hardcover-fiction/#QmVzdFNlbGxlckJvb2s6LTk3ODEyNTA4ODQzMTI=",
"publisher": "Flatiron",
"description": "The third book in the Ninth House series. Alex and her allies battle demons found in New Haven and on the Yale campus.",
"weeks_on_list": 1,
"rank_last_week": null,
"book_review_link": null,
"cover_image_link": "https://static01.nyt.com/bestsellers/images/9781250884312.jpg"
},
{
"rank": 2,
"title": "HOLLOW BONES",
"author": "Jodi Picoult",
"isbn_13": "9780593726259",
"buy_links": [
{
"link": "https://www.amazon.com/dp/0593726251?tag=thenewyorktim-20",
"store_name": "Amazon"
},
{
"link": "https://goto.applebooks.apple/9780593726259?at=10lIEQ",
"store_name": "Apple Books"
}
],
"page_link": "https://www.nytimes.com/books/best-sellers/2026/10/04/hardcover-fiction/#QmVzdFNlbGxlckJvb2s6LTk3ODA1OTM3MjYyNTk=",
"publisher": "Ballantine",
"description": "A woman who runs the Rhode Island Department for Emergency Preparedness and her husband, who is a police polygraph expert, face a crisis in their marriage.",
"weeks_on_list": 1,
"rank_last_week": null,
"book_review_link": null,
"cover_image_link": "https://static01.nyt.com/bestsellers/images/9780593726259.jpg"
}
],
"list_name": "Hardcover Fiction",
"published_date": "2026-10-04"
}List headlines
1 creditList current New York Times headlines and summaries in the order shown on a chosen section page. Video-only items, ads and promotions are excluded; dates may be unavailable.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Sectionsection | Text | Optional | News section to read, for example world.Example: top stories |
Max Resultsmax_results | Number | Optional | Most stories to return, for example 20.Example: 20 |
What you get
| Field | Type | Description |
|---|---|---|
Storiesstories | List | News stories in the section page order. |
Authorsstories[].authors | List | Named writers, when available. |
Sectionstories[].section | Text | Selected news section.Example: top stories |
Summarystories[].summary | Text | Summary shown on the section page, if available.Example: Criminal hackers stole personal data involving potentially tens of thousands… |
Headlinestories[].headline | Text | Headline as shown on the section page.Example: Embarrassing Breach at F.B.I. Fuels Fears of Harm to Its Employees |
Image URLstories[].image_url | Text | Image link shown with the story, if any.Example: https://static01.nyt.com/images/2026/09/28/multimedia/28dc-fbi-top-hgcb/28dc-fb… |
Article URLstories[].article_url | Text | The New York Times story link.Example: https://www.nytimes.com/2026/09/28/us/politics/fbi-shinyhunters-damage.html |
Published Atstories[].published_at | Text | Publication date and time with timezone, if available.Example: 2026-09-28T21:36:07+00:00 |
Example result
For Section: top stories, Max Results: 20
{
"stories": [
{
"authors": [
"Dustin Volz",
"Alan Feuer",
"Charlie Savage"
],
"section": "top stories",
"summary": "Criminal hackers stole personal data involving potentially tens of thousands of former and current employees, leaving the bureau rushing to protect its staff.",
"headline": "Embarrassing Breach at F.B.I. Fuels Fears of Harm to Its Employees",
"image_url": "https://static01.nyt.com/images/2026/09/28/multimedia/28dc-fbi-top-hgcb/28dc-fbi-top-hgcb-mediumSquareAt3X.jpg",
"article_url": "https://www.nytimes.com/2026/09/28/us/politics/fbi-shinyhunters-damage.html",
"published_at": "2026-09-28T21:36:07+00:00"
},
{
"authors": [
"Matthew C. Klein"
],
"section": "top stories",
"summary": "A shift in fuel economy rules, Republicans’ major ad blitz and a phone-free concert.",
"headline": "Catch Up on Today’s Biggest Stories",
"image_url": "https://static01.nyt.com/images/2026/09/28/multimedia/28evening-nl-top1/28evening-nl-top1-mediumSquareAt3X.jpg",
"article_url": "https://www.nytimes.com/2026/09/28/briefing/trump-sharply-scales-back-fuel-economy-rules.html",
"published_at": "2026-09-28T22:05:33+00:00"
},
{
"authors": [
"Kim Barker",
"Maria Varenikova",
"Oleksandra Mykolyshyn"
],
"section": "top stories",
"summary": "A Russian jet-powered drone hit Ukraine’s National Academy of Sciences, the source of almost all of the country’s major scientific discoveries.",
"headline": "Fire, Smoke and Desperation After a Strike in the Heart of Kyiv",
"image_url": "https://static01.nyt.com/images/2026/09/28/multimedia/28ukraine-strike-01-fmzj/28ukraine-strike-01-fmzj-mediumSquareAt3X.jpg",
"article_url": "https://www.nytimes.com/2026/09/28/world/europe/urkaine-drone-attack-kyiv-academy-sciences.html",
"published_at": "2026-09-28T19:33:55+00:00"
}
]
}Search news
1 creditSearch New York Times article headlines and summaries by keyword and return matching dates, authors, sections and links. Public listings only; excludes full story text and The Athletic.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Pagepage | Number | Optional | Page number starting at 1, for example 2.Example: 1 |
Sortsort | Text | Optional | Order results by newest or most relevant, for example newest.Example: Most relevant |
Queryquery | Text | Required | Words to search in New York Times articles, for example Tesla.Example: Tesla |
To Dateto_date | Date | Optional | Latest publication date, inclusive, for example 2026-09-28.Example: 2026-09-27 |
From Datefrom_date | Date | Optional | Earliest publication date, inclusive, for example 2026-09-01.Example: 2026-09-01 |
Max Resultsmax_results | Number | Optional | Maximum articles on this page, up to 50, for example 20.Example: 10 |
What you get
| Field | Type | Description |
|---|---|---|
Articlesarticles | List | New York Times articles matching the search. |
Authorsarticles[].authors | List | |
Sectionarticles[].section | Text | Example: Business |
Summaryarticles[].summary | Text | Example: The new Cybercab embodies Elon Musk’s vision of cars that drive themselves… |
Headlinearticles[].headline | Text | Example: Tesla Begins Offering Rides in a Car Without a Steering Wheel |
Article Linkarticles[].article_link | Link | Example: https://www.nytimes.com/2026/09/03/business/tesla-cybercab-robotaxi-rides.html |
Published Atarticles[].published_at | Date | Example: 2026-09-03T22:12:46+00:00 |
Example result
For Page: 1, Sort: Most relevant, Query: Tesla, To Date: 2026-09-27, From Date: 2026-09-01, Max Results: 10
{
"articles": [
{
"authors": [
"Jack Ewing"
],
"section": "Business",
"summary": "The new Cybercab embodies Elon Musk’s vision of cars that drive themselves, but it is not clear when the vehicle will be widely available.",
"headline": "Tesla Begins Offering Rides in a Car Without a Steering Wheel",
"article_link": "https://www.nytimes.com/2026/09/03/business/tesla-cybercab-robotaxi-rides.html",
"published_at": "2026-09-03T22:12:46+00:00"
},
{
"authors": [
"Jack Ewing"
],
"section": "Business",
"summary": "The National Highway Traffic Safety Administration said it would examine whether the company’s new self-driving taxi, which has no steering wheel, meets federal auto regulations.",
"headline": "Tesla’s Cybercab Is Being Investigated by Federal Regulators",
"article_link": "https://www.nytimes.com/2026/09/04/business/tesla-cybercab-nhtsa-investigation.html",
"published_at": "2026-09-04T13:19:46+00:00"
}
]
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@the-new-york-times",
"visibility": "public",
"operation": "list_best_sellers",
"version": 1,
"input": {
"list_name": "Hardcover Fiction"
},
"response": {
"format": "json"
}
}'What you can do with it
- Track headlines across selected news sections.
- Find articles about a keyword within a date range.
- Compare article coverage by section and publication date.
- Monitor book rankings across best seller lists.
- Review book authors, publishers, and time on a list.
Questions about The New York Times
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this The New York Times tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a The New York Times account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from nytimes.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 28, 2026.
What headlines appear in a news section?
List headlines returns stories in the order shown on the chosen section page.
Which articles match a keyword and date range?
Search news returns matching article headlines and summaries, with dates, authors, sections, and links.
What books are on a best seller list?
List best sellers returns books and their ranks for the specified list name and issue.