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.

List best sellers

Get 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.

Your information

List Name

The list name in plain words, such as Hardcover Fiction or Young Adult Hardcover.

More options

WeekOptional

Any day in the requested list week, for example 2025-03-25. Leave out for the latest issue.

1 credit per run

Results

What you’ll get

Each run returns the following information.

Books: A list of items
List Name: Text
Published Date: A date

Your information carries over to Studio.

About The New York Times

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 by Fous from nytimes.com and checked automatically; it last passed a check on Sep 28, 2026. Fous is not affiliated with The New York Times.

Actions

List best sellers

1 credit per run

Get 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
Week`week`	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 Name`list_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
Books`books`	List
Rank`books[].rank`	Number	Position on this list.
Title`books[].title`	Text
Author`books[].author`	Text
ISBN 13`books[].isbn_13`	Text
Buy Links`books[].buy_links`	List
Page Link`books[].page_link`	Text	Link to this book on its Best Sellers page.
Publisher`books[].publisher`	Text
Description`books[].description`	Text
Weeks On List`books[].weeks_on_list`	Number	Number of issues on the list.
Rank Last Week`books[].rank_last_week`	Number	Rank on the preceding list, or null if not ranked then.
Book Review Link`books[].book_review_link`	Text
Cover Image Link`books[].cover_image_link`	Text
List Name`list_name`	Text
Published Date`published_date`	Date

List headlines

1 credit per run

List 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
Section`section`	Text	Optional	News section to read, for example world.Example: top stories
Max Results`max_results`	Number	Optional	Most stories to return, for example 20.Example: 20

What you get

Field	Type	Description
Stories`stories`	List	News stories in the section page order.
Authors`stories[].authors`	List	Named writers, when available.
Section`stories[].section`	Text	Selected news section.
Summary`stories[].summary`	Text	Summary shown on the section page, if available.
Headline`stories[].headline`	Text	Headline as shown on the section page.
Image URL`stories[].image_url`	Text	Image link shown with the story, if any.
Article URL`stories[].article_url`	Text	The New York Times story link.
Published At`stories[].published_at`	Text	Publication date and time with timezone, if available.

Search news

1 credit per run

Search 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
Page`page`	Number	Optional	Page number starting at 1, for example 2.Example: 1
Sort`sort`	Text	Optional	Order results by newest or most relevant, for example newest.Example: Most relevant
Query`query`	Text	Required	Words to search in New York Times articles, for example Tesla.Example: Tesla
To Date`to_date`	Date	Optional	Latest publication date, inclusive, for example 2026-09-28.Example: 2026-09-27
From Date`from_date`	Date	Optional	Earliest publication date, inclusive, for example 2026-09-01.Example: 2026-09-01
Max Results`max_results`	Number	Optional	Maximum articles on this page, up to 50, for example 20.Example: 10

What you get

Field	Type	Description
Articles`articles`	List	New York Times articles matching the search.
Authors`articles[].authors`	List
Section`articles[].section`	Text	Example: Business
Summary`articles[].summary`	Text	Example: The new Cybercab embodies Elon Musk’s vision of cars that drive themselves…
Headline`articles[].headline`	Text	Example: Tesla Begins Offering Rides in a Car Without a Steering Wheel
Article Link`articles[].article_link`	Link	Example: https://www.nytimes.com/2026/09/03/business/tesla-cybercab-robotaxi-rides.html
Published At`articles[].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

JSON

{
  "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

Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.

cURL

# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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

Is Fous affiliated with The New York Times?

No. Fous is not affiliated with The New York Times. This workflow reads the public nytimes.com website and returns its data.

How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 28, 2026.