Reuters API: List headlines
Lists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order.
Unofficial. Not affiliated with or endorsed by Reuters.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Section optional
section News section to list, for example world.
business
One of
top stories,business,markets,world,technology,legal,sustainability. Defaulttop stories.- Max Results optional
max_results Maximum number of stories, for example 20 (up to 50).
20
Whole number from 1 to 50. Default
20.
Input as JSON
{ "section": "business", "max_results": 20}Output
{ "stories": [ { "authors": [], "section": "business", "summary": "Crude oil exports from key Middle East producers rebounded in September to 16.328 million barrels per day (bpd), the highest since the US-Israeli war on Iran started in late February, data from Kpler showed on Monday, as Saudi Arabia and the United Arab Emirates boosted exports.", "headline": "Mideast oil exports rebound in September as Saudi Arabia boosts shipments", "image_url": "https://www.reuters.com/resizer/v2/SV4QXERQVVIFBHHIG2ADIS2ORQ.jpg?auth=d76bf6276e3dfab8dfd282ddccf3db36ebaa40a26cd56264a35b67fe46cb03ed&width=1200&quality=80" , "article_url": "https://www.reuters.com/business/energy/mideast-oil-exports-rebound-september-saudi-arabia-boosts-shipments-2026-09-28/" , "published_at": "2026-09-29T02:43:17.292000+00:00" }, { "authors": [], "section": "business", "summary": null, "headline": "Anthropic's IPO prospectus shows sweeping AI vision, surging costs", "image_url": null, "article_url": "https://www.reuters.com/business/finance/anthropics-ipo-prospectus-shows-sweeping-ai-vision-surging-costs-2026-09-28/" , "published_at": "2026-09-29T02:36:27.141000+00:00" }, { "authors": [], "section": "business", "summary": null, "headline": "OpenAI apologies for Australian government website hack, pledges to rebuild trust", "image_url": null, "article_url": "https://www.reuters.com/legal/litigation/openai-says-ai-models-accessed-australian-government-systems-without-2026-09-29/" , "published_at": "2026-09-29T03:26:18.739000+00:00" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"reuters.com/list_headlines","input":{"section":"business","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": "reuters.com/list_headlines" , "input": { "section": "business", "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": "reuters.com/list_headlines" , "input": { "section": "business", "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 reuters.com/list_headlines# with {"section":"business","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", "business", "markets", "world", "technology", "legal", "sustainability" ], "type": "string", "default": "top stories", "description": "News section to list, for example world." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of stories, for example 20 (up to 50)." } }}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" } }, "section": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "image_url": { "type": [ "string", "null" ] }, "article_url": { "type": "string" }, "published_at": { "type": [ "string", "null" ], "description": "Publication time in ISO 8601 with offset, if shown." } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
reuters.com/list_headlines- Returns
- headline, summary, publication time, authors, image, article URL
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 reuters.com/list_headlines with the inputs above.
Ask your agent
- Pull the 10 most recent Reuters business stories with their summaries and publish times
- What are the latest headlines in world news right now? Give me about 25 with links.
- Show me the newest technology news articles, including authors and images, up to 15
- I need the current top stories from reuters.com — just the first 5 headlines and URLs
- Get me the latest 40 markets news items with headline, summary, and timestamp
See more
All Reuters methodsSearches 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.
reuters.com/search_newsLists 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 AP News headlines in the order shown on a public section page, up to 50 stories. Author credits and the article section are added for the first 20 articles only.
apnews.com/list_headlinesLists the headlines shown in a Wall Street Journal news section (top stories, business, markets, tech, economy, world, politics or personal finance) with summaries, bylines, dates, images and story links.
wsj.com/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 headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links.
npr.org/list_headlinesLists CNN headlines in the order shown on a chosen news section page (top stories, US, world, politics, business, health, entertainment or science), with each story's summary, publication time, authors and image when available. Promotions and video-only items are left out.
cnn.com/list_headlinesLists 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.
nytimes.com/list_headlines