# 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. - Page: https://fous.com/methods/reuters.com/list-headlines - Method: `reuters.com/list_headlines`, version 1 - Website: reuters.com - Returns: headline, summary, publication time, authors, image, article URL - 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 | `"business"` | News section to list, for example world. One of "top stories", "business", "markets", "world", "technology", "legal", "sustainability". Default "top stories". | | `max_results` | integer | no | `20` | Maximum number of stories, for example 20 (up to 50). Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "section": "business", "max_results": 20 } ``` Its output: ```json { "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" } ] } ``` ## 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":"reuters.com/list_headlines","input":{"section":"business","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 - 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 ## Input schema ```json { "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 ```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" } }, "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 } ``` ## See more - [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. - [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. - [AP News API: List headlines](https://fous.com/methods/apnews.com/list-headlines.md): Lists 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. - [wsj.com API: List Wall Street Journal section headlines](https://fous.com/methods/wsj.com/list-headlines.md): Lists 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. - [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. - [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. - [CNN API: List headlines by section](https://fous.com/methods/cnn.com/list-headlines.md): Lists 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. - [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. - [All Reuters methods](https://fous.com/methods/reuters.com.md)