# BBC News API: List headlines > Lists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link. Unofficial. Not affiliated with or endorsed by BBC News. - Page: https://fous.com/methods/bbc.com/list-headlines - Method: `bbc.com/list_headlines`, version 1 - Website: bbc.com - Returns: headline, summary, published_at, 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"` | The news section to list, for example world. One of "top stories", "world", "UK", "US and Canada", "business", "technology", "science", "health". Default "top stories". | | `max_results` | integer | no | `5` | Maximum number of stories to return, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "section": "top stories", "max_results": 5 } ``` Its output: ```json { "stories": [ { "authors": [ "Barbara Plett Usher", "Mohamed Madi" ], "section": "top stories", "summary": "The UN human rights chief Volker Türk says the multiple attacks may amount to war crimes.", "headline": "Hospitals deliberately targeted by Sudan's RSF fighters, BBC finds", "image_link": "https://ichef.bbci.co.uk/news/480/cpsprodpb/d6bf/live/fa5ffcb0-ce31-11f1-bc2e-018d645d8d21.jpg", "article_link": "https://www.bbc.com/news/articles/c54g1kxw4nvvo", "published_at": "2026-10-22T23:16:16.492000+00:00" }, { "authors": [ "Daniel De Simone", "Nalini Sivathasan" ], "section": "top stories", "summary": "Linda Williams was attacked by David Carrick, who was jailed in 2023 for sexual offences against 12 women.", "headline": "UK detective raped by colleague says police's handling of case 'like being raped again'", "image_link": "https://ichef.bbci.co.uk/news/480/cpsprodpb/3bae/live/f5a32300-ce54-11f1-a166-e30097724580.jpg", "article_link": "https://www.bbc.com/news/articles/ckdd83dz0153o", "published_at": "2026-10-23T05:00:05.833000+00:00" }, { "authors": [ "Jamie Whitehead", "Gabriela Pomeroy" ], "section": "top stories", "summary": "Protests will only be allowed in some towns and cities if organised by unions, and top museums will be closed on Saturday.", "headline": "Paris extends curfew as Marseille and Lyon ban protests after riots", "image_link": "https://ichef.bbci.co.uk/news/480/cpsprodpb/d603/live/9c9fdf10-ce4e-11f1-8507-d7f0bcb84e7e.jpg", "article_link": "https://www.bbc.com/news/articles/cvde8g40xx42o", "published_at": "2026-10-22T13:02:14.382000+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":"bbc.com/list_headlines","input":{"section":"top stories","max_results":5}}' ``` 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 - Show me the latest headlines from the BBC World section, up to 15 stories - What are today's top stories on BBC News? - Pull the 10 most recent UK news headlines with their publish times and authors - Give me the business headlines from BBC News along with summaries and article links - List up to 30 science and technology stories currently on the BBC news site ## Input schema ```json { "type": "object", "properties": { "section": { "enum": [ "top stories", "world", "UK", "US and Canada", "business", "technology", "science", "health" ], "type": "string", "default": "top stories", "description": "The news section to list, for example world." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of 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_link", "article_link" ], "properties": { "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "image_link": { "type": [ "string", "null" ] }, "article_link": { "type": "string" }, "published_at": { "type": [ "string", "null" ], "format": "date-time", "description": "Publication time if a date appears on the section card." } }, "additionalProperties": false }, "description": "BBC News stories in the order displayed on the section page." } }, "additionalProperties": false } ``` ## See more - [BBC News API: Search articles](https://fous.com/methods/bbc.com/search-news.md): Finds BBC News articles matching search words, newest first or by relevance, with publication time, authors, section and summary, optionally limited to a date range. Date filters and newest order apply to the first 180 search matches; older or less relevant matches may be missed. - [BBC News API: Read article](https://fous.com/methods/bbc.com/read-article.md): Reads the text and details of a BBC News article from its link or headline. Live coverage pages return the latest entries available. - [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 Guardian API: List headlines](https://fous.com/methods/theguardian.com/list-headlines.md): 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. - [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. - [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. - [All BBC News methods](https://fous.com/methods/bbc.com.md)