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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Section optional
section News section to read, for example world.
world
One of
top stories,world,U.S.,politics,business,technology,opinion,arts,science. Defaulttop stories.- Max Results optional
max_results Most stories to return, for example 20.
20
Whole number from 1 to 50. Default
20.
Input as JSON
{ "section": "world", "max_results": 20}Output
{ "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" } ]}Code
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}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "nytimes.com/list_headlines" , "input": { "section": "world", "max_results": 20 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "nytimes.com/list_headlines" , "input": { "section": "world", "max_results": 20 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run nytimes.com/list_headlines# with {"section":"world","max_results":20}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
nytimes.com/list_headlines- Returns
- stories (headline, summary, published time, authors, section, image, article link)
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method nytimes.com/list_headlines with the inputs above.
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.
See more
All The New York Times methodsSearches 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.
nytimes.com/search_newsGets 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.
nytimes.com/list_best_sellersLists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links.
npr.org/list_headlinesLists 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.
yahoo.com/list_headlinesLists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order.
reuters.com/list_headlinesLists Fox News article headlines in the order shown on a news section page. Video-only items, ads and promotions are left out.
foxnews.com/list_headlinesLists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link.
bbc.com/list_headlinesLists Times of India headlines for a news section or city page, in page order, with article details. Skips video-only items and advertisements.
timesofindia.indiatimes.com/list_headlines