# The Guardian API: List headlines > Lists the stories on a Guardian section front (top stories, world, UK, US, business, environment, technology, sport or culture) in page order, with the summary and image shown on the front, the publication time (as displayed, else from the story page), and each story's section and authors from its page. Unofficial. Not affiliated with or endorsed by The Guardian. - Page: https://fous.com/methods/theguardian.com/list-headlines - Method: `theguardian.com/list_headlines`, version 1 - Website: theguardian.com - Returns: headline, summary, publication time, authors, section, image link, 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 | `"top stories"` | News section to list, for example world. One of "top stories", "world", "UK", "US", "business", "environment", "technology", "sport", "culture". Default "top stories". | | `max_results` | integer | no | `20` | Maximum number of stories, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "section": "top stories", "max_results": 20 } ``` Its output: ```json { "stories": [ { "authors": [ "Nick Visser" ], "section": "US news", "summary": "The ocean phenomenon could raise sea levels by up to a foot as El Niño keeps warm water trapped along the coast", "headline": "Concern mounts over slow-moving, planetary-scale ‘Kelvin’ wave heading for California", "image_link": "https://i.guim.co.uk/img/media/9e5107f1d6a166f37f2f8a6a9f3796bed818b2b4/671_0_6713_5372/master/6713.jpg?width=465&dpr=1&s=none&crop=5%3A4", "article_link": "https://www.theguardian.com/us-news/2026/sep/28/california-kelvin-wave", "published_at": null }, { "authors": [], "section": "US news", "summary": null, "headline": "Trump administration to slash clean car rules aimed at cutting climate emissions", "image_link": null, "article_link": "https://www.theguardian.com/us-news/2026/sep/28/trump-administration-slashes-clean-car-rules", "published_at": null }, { "authors": [ "Sara Sneath" ], "section": "US news", "summary": null, "headline": "Decades of fossil fuel influence paved way for Trump’s assault on university research, study says", "image_link": null, "article_link": "https://www.theguardian.com/us-news/2026/sep/28/fossil-fuel-industry-climate-research-universities-study", "published_at": null } ] } ``` ## 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":"theguardian.com/list_headlines","input":{"section":"top stories","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 Guardian right now? Give me the first 10 with headlines, summaries and who wrote them. - Pull the latest 25 environment stories from theguardian.com, including publication times and links. - Show me what's leading the world news front today: headlines, authors, and article URLs for the top 15 pieces. - I need the current tech headlines in the order they appear on the page, with the image links and the summary blurbs. Just 5 is fine. - List the first 30 sport stories running now, with each one's byline, section, and when it was published. ## Input schema ```json { "type": "object", "properties": { "section": { "enum": [ "top stories", "world", "UK", "US", "business", "environment", "technology", "sport", "culture" ], "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." } } } ``` ## Output schema ```json { "type": "object", "required": [ "stories" ], "properties": { "stories": { "type": "array", "items": { "type": "object", "required": [ "headline", "summary", "published_at", "authors", "section", "image_link", "article_link" ], "properties": { "authors": { "type": "array", "items": { "type": "string" }, "description": "Named story authors, when available." }, "section": { "type": [ "string", "null" ], "description": "Story section." }, "summary": { "type": [ "string", "null" ], "description": "Summary shown on the section page, if any." }, "headline": { "type": "string", "description": "Story headline." }, "image_link": { "type": [ "string", "null" ], "description": "Story image link, if any." }, "article_link": { "type": "string", "description": "Guardian story page link." }, "published_at": { "type": [ "string", "null" ], "description": "Displayed publication time in ISO 8601, if any." } }, "additionalProperties": false }, "description": "Stories in section-page order." } }, "additionalProperties": false } ``` ## See more - [The Guardian API: Search news](https://fous.com/methods/theguardian.com/search-news.md): Searches Guardian articles by keyword through the public Google News feed for theguardian.com, optionally within publication dates, ordered newest first or by relevance, and returns each article's headline, summary, authors, section and publication time from its Guardian page. - [The Guardian API: Read article](https://fous.com/methods/theguardian.com/read-article.md): Reads one public Guardian article by link or headline and returns its details and available full-text paragraphs. Live blogs return the latest entries shown on the page; some older articles may be unavailable. - [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. - [The Verge API: List headlines](https://fous.com/methods/theverge.com/list-headlines.md): Lists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed. - [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. - [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. - [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 The Guardian methods](https://fous.com/methods/theguardian.com.md)