# The New York Times API: List headlines > 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. Unofficial. Not affiliated with or endorsed by The New York Times. - Page: https://fous.com/methods/nytimes.com/list-headlines - Method: `nytimes.com/list_headlines`, version 1 - Website: nytimes.com - Returns: stories (headline, summary, published time, authors, section, image, 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 | |---|---|---|---|---| | `section` | string | no | `"world"` | News section to read, for example world. One of "top stories", "world", "U.S.", "politics", "business", "technology", "opinion", "arts", "science". Default "top stories". | | `max_results` | integer | no | `20` | Most stories to return, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "section": "world", "max_results": 20 } ``` Its output: ```json { "stories": [ { "authors": [ "Michael D. Shear" ], "section": "world", "summary": "The British counterterrorism police said the five British nationals arrested near R.A.F. Fairford on Sunday were being released on bail but remained under investigation.", "headline": "Release of 5 Men in U.K. Prompts New Questions Over Possible Terror Plot", "image_url": "https://static01.nyt.com/images/2026/09/28/multimedia/28int-uk-airbase-01-lqhf/28int-uk-airbase-01-lqhf-thumbLarge.jpg?auto=avif&quality=75", "article_url": "https://www.nytimes.com/2026/09/28/world/europe/us-air-base-uk-terror-incident-fairford.html", "published_at": "2026-09-28T20:05:26+00:00" }, { "authors": [ "Elisabetta Povoledo" ], "section": "world", "summary": "The verdict followed a decade-long effort in Italy to account for the killing of Giulio Regeni, an Italian researcher who disappeared in Cairo in 2016.", "headline": "3 Egyptian Officials Convicted of Kidnapping Slain Italian Student", "image_url": "https://static01.nyt.com/images/2026/09/28/multimedia/28int-italy-egypt-lqkj/28int-italy-egypt-lqkj-thumbLarge.jpg?auto=avif&quality=75", "article_url": "https://www.nytimes.com/2026/09/28/world/europe/italy-egypt-giulio-regeni-verdict.html", "published_at": "2026-09-28T20:22:21+00:00" }, { "authors": [ "Vivian Nereim" ], "section": "world", "summary": "The fighting between the Iran-backed Houthi militia and Saudi-backed government forces has exacerbated one of the world’s worst humanitarian crises, the World Health Organization said.", "headline": "Renewed War in Yemen Has Killed More Than 800, W.H.O. Says", "image_url": "https://static01.nyt.com/images/2026/09/28/multimedia/28int-yemen-war-1-pljq/28int-yemen-war-1-pljq-thumbLarge.jpg?auto=avif&quality=75", "article_url": "https://www.nytimes.com/2026/09/28/world/middleeast/yemen-war-800-dead.html", "published_at": "2026-09-28T16:20:37+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/list_headlines","input":{"section":"world","max_results":20}}' ``` 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 - What are the top stories on the New York Times homepage right now? Give me the headlines with short summaries. - Pull the latest 10 technology headlines with authors and links to the full articles. - I need the current world news headlines, about 30 of them, with publication times and images. - Show me what's running in the NYT opinion section today: who wrote each piece and what it's about. - List the five most recent science stories, including bylines and when they were published. ## Input schema ```json { "type": "object", "properties": { "section": { "enum": [ "top stories", "world", "U.S.", "politics", "business", "technology", "opinion", "arts", "science" ], "type": "string", "default": "top stories", "description": "News section to read, for example world." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Most stories to return, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "stories" ], "properties": { "stories": { "type": "array", "items": { "type": "object", "required": [ "headline", "summary", "published_at", "authors", "section", "image_url", "article_url" ], "properties": { "authors": { "type": "array", "items": { "type": "string" }, "description": "Named writers, when available." }, "section": { "type": "string", "description": "Selected news section." }, "summary": { "type": [ "string", "null" ], "description": "Summary shown on the section page, if available." }, "headline": { "type": "string", "description": "Headline as shown on the section page." }, "image_url": { "type": [ "string", "null" ], "description": "Image link shown with the story, if any." }, "article_url": { "type": "string", "description": "The New York Times story link." }, "published_at": { "type": [ "string", "null" ], "description": "Publication date and time with timezone, if available." } }, "additionalProperties": false }, "description": "News stories in the section page order." } }, "additionalProperties": false } ``` ## See more - [The New York Times API: Search articles](https://fous.com/methods/nytimes.com/search-news.md): 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. - [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. - [NPR API: List headlines](https://fous.com/methods/npr.org/list-headlines.md): Lists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links. - [Yahoo API: List Yahoo News headlines](https://fous.com/methods/yahoo.com/list-headlines.md): Lists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them. - [Reuters API: List headlines](https://fous.com/methods/reuters.com/list-headlines.md): Lists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order. - [Fox News API: List headlines](https://fous.com/methods/foxnews.com/list-headlines.md): Lists Fox News article headlines in the order shown on a news section page. Video-only items, ads and promotions are left out. - [BBC News API: List headlines](https://fous.com/methods/bbc.com/list-headlines.md): Lists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link. - [Times of India API: List headlines](https://fous.com/methods/timesofindia.indiatimes.com/list-headlines.md): Lists Times of India headlines for a news section or city page, in page order, with article details. Skips video-only items and advertisements. - [All The New York Times methods](https://fous.com/methods/nytimes.com.md)