# The New York Times API: Search articles > 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. Unofficial. Not affiliated with or endorsed by The New York Times. - Page: https://fous.com/methods/nytimes.com/search-news - Method: `nytimes.com/search_news`, version 1 - Website: nytimes.com - Returns: headline, summary, published date, authors, section, article link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `page` | integer | no | | Page number starting at 1, for example 2. Default 1. | | `sort` | string | no | | Order results by newest or most relevant, for example newest. One of "newest", "most_relevant". Default "newest". | | `query` | string | yes | `"Tesla"` | Words to search in New York Times articles, for example Tesla. | | `to_date` | string | no | | Latest publication date, inclusive, as YYYY-MM-DD, for example 2026-09-28. | | `from_date` | string | no | | Earliest publication date, inclusive, as YYYY-MM-DD, for example 2026-09-01. | | `max_results` | integer | no | | Maximum articles on this page, up to 50, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "query": "Tesla" } ``` Its output: ```json { "articles": [ { "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" }, { "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": [ "Keith Bradsher and Jack Ewing" ], "section": "Business", "summary": "China’s regulator ordered changes after vehicle occupants sometimes had difficulty exiting electric cars, an issue that has led to lawsuits against Tesla in the United States.", "headline": "In China’s Biggest Car Recall, Tesla and 8 Others Will Address Door Safety", "article_link": "https://www.nytimes.com/2026/08/21/business/china-car-recall-doors.html", "published_at": "2026-08-21T15:09:20+00:00" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"nytimes.com/search_news","input":{"query":"Tesla"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find New York Times articles about the Federal Reserve interest rate decision published between 2025-03-01 and 2025-03-31, newest first - What has the Times written about Ozempic and weight loss drugs? Give me the most relevant pieces with authors and links - Pull up 10 articles mentioning Taylor Swift from the last two weeks of October 2024, including headline, date and section - search nytimes.com for coverage of the Maui wildfires, sorted by relevance, show me page 2 of results - I need recent reporting on OpenAI's leadership shakeup — headlines, summaries and article URLs, up to 30 results ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "page": { "type": "integer", "default": 1, "minimum": 1, "description": "Page number starting at 1, for example 2." }, "sort": { "enum": [ "newest", "most_relevant" ], "type": "string", "default": "newest", "description": "Order results by newest or most relevant, for example newest." }, "query": { "type": "string", "minLength": 1, "description": "Words to search in New York Times articles, for example Tesla." }, "to_date": { "type": "string", "description": "Latest publication date, inclusive, as YYYY-MM-DD, for example 2026-09-28." }, "from_date": { "type": "string", "description": "Earliest publication date, inclusive, as YYYY-MM-DD, for example 2026-09-01." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum articles on this page, up to 50, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "articles" ], "properties": { "articles": { "type": "array", "items": { "type": "object", "required": [ "headline", "summary", "published_at", "authors", "section", "article_link" ], "properties": { "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "article_link": { "type": "string", "format": "uri" }, "published_at": { "type": "string", "format": "date-time" } } }, "description": "New York Times articles matching the search." } } } ``` ## See more - [The New York Times API: List headlines](https://fous.com/methods/nytimes.com/list-headlines.md): 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. - [The New York Times API: List New York Times Best Sellers](https://fous.com/methods/nytimes.com/list-best-sellers.md): 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. - [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section. - [NPR API: Search news](https://fous.com/methods/npr.org/search-news.md): Searches NPR-published articles by keyword, newest first or by best match, with optional publication dates, and returns each article's date, authors, section and summary. - [Reuters API: Search news](https://fous.com/methods/reuters.com/search-news.md): Searches Reuters articles by keyword through Google News, with optional publication date range, order and page. Summaries and bylines are filled in when Reuters serves the article page. - [wsj.com API: Search Wall Street Journal articles](https://fous.com/methods/wsj.com/search-news.md): Searches public Wall Street Journal headlines and summaries by keyword, newest or most relevant first, optionally within publication dates; podcasts and live-coverage posts are left out. - [BBC News API: Search articles](https://fous.com/methods/bbc.com/search-news.md): Finds BBC News articles matching search words, newest first or by relevance, with publication time, authors, section and summary, optionally limited to a date range. Date filters and newest order apply to the first 180 search matches; older or less relevant matches may be missed. - [Fox News API: Search articles](https://fous.com/methods/foxnews.com/search-news.md): Searches Fox News articles by keyword, with date filtering, ordering and pagination, over the first 100 matches. - [All The New York Times methods](https://fous.com/methods/nytimes.com.md)