BBC News API: Search articles
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.
Unofficial. Not affiliated with or endorsed by BBC News.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Page optional
page Result page number, for example 2.
1 (default)
Whole number 1 or more.
- Sort optional
sort Order articles by publication time or search relevance, for example newest.
newest (default)
One of
newest,most_relevant.- Query, required
query Words to look for in BBC News, for example Tesla.
Tesla
- To Date optional
to_date Include articles published on or before this date (YYYY-MM-DD), for example 2026-09-28.
Not set
- From Date optional
from_date Include articles published on or after this date (YYYY-MM-DD), for example 2026-09-01.
Not set
- Max Results optional
max_results Articles per page, up to 50, for example 20.
20 (default)
Whole number from 1 to 50.
Input as JSON
{ "query": "Tesla"}Output
{ "articles": [ { "link": "https://www.bbc.com/news/articles/ckp84gly996do" , "authors": [ "Chloe Parkman" ], "section": "News", "summary": "Officials say demand for lithium is expected to increase by 1,100% by 2035.", "headline": "New lithium mine in Cornwall 'set to create more than 100 jobs'", "published_at": "2026-09-27T14:09:19.644000+00:00" }, { "link": "https://www.bbc.com/news/articles/c6p3kxpp8lezo" , "authors": [ "Dearbail Jordan" ], "section": "Business", "summary": "Stock in major firms such as Microsoft, Nvidia and SpaceX was bought and sold on behalf of the US president.", "headline": "Trump reveals millions of dollars' worth of share deals in big tech and AI", "published_at": "2026-09-23T14:35:30.201000+00:00" }, { "link": "https://www.bbc.com/news/articles/cx2zg554w9ko" , "authors": [ "Osmond Chia" ], "section": "Business", "summary": "The 21 Air-operated jet overshot a runway at Miami International Airport and hit several vehicles.", "headline": "Amazon crash: Firm pauses work with cargo carrier after fatal incident", "published_at": "2026-09-14T02:01:29.157000+00:00" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"bbc.com/search_news","input":{"query":"Tesla"}}' # 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": "bbc.com/search_news" , "input": { "query": "Tesla" }})# 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": "bbc.com/search_news" , "input": { "query": "Tesla" } }), 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 bbc.com/search_news# with {"query":"Tesla"}"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", "required": [ "query" ], "properties": { "page": { "type": "integer", "default": 1, "minimum": 1, "description": "Result page number, for example 2." }, "sort": { "enum": [ "newest", "most_relevant" ], "type": "string", "default": "newest", "description": "Order articles by publication time or search relevance, for example newest." }, "query": { "type": "string", "minLength": 1, "description": "Words to look for in BBC News, for example Tesla." }, "to_date": { "type": "string", "description": "Include articles published on or before this date (YYYY-MM-DD), for example 2026-09-28." }, "from_date": { "type": "string", "description": "Include articles published on or after this date (YYYY-MM-DD), for example 2026-09-01." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Articles per page, up to 50, for example 20." } }}Output schema
{ "type": "object", "required": [ "articles" ], "properties": { "articles": { "type": "array", "items": { "type": "object", "required": [ "headline", "summary", "published_at", "authors", "section", "link" ], "properties": { "link": { "type": "string", "format": "uri" }, "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "published_at": { "type": "string", "format": "date-time" } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
bbc.com/search_news- Returns
- headline, summary, published at, authors, section, 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 bbc.com/search_news with the inputs above.
Ask your agent
- Find the latest BBC News articles about the Gaza ceasefire talks, newest first, with authors and summaries
- What has the BBC published on UK interest rates between 2025-03-01 and 2025-03-31? Give me headlines and links.
- Show me the 10 most relevant news articles about Elon Musk's xAI, including which section each ran in
- I need page 2 of recent news coverage mentioning heatwave Spain, 30 results per page
- Pull news articles about the Champions League final published from 2025-05-25 to 2025-06-02, with publication times and bylines
See more
All BBC News methodsLists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link.
bbc.com/list_headlinesReads the text and details of a BBC News article from its link or headline. Live coverage pages return the latest entries available.
bbc.com/read_articleSearches Fox News articles by keyword, with date filtering, ordering and pagination, over the first 100 matches.
foxnews.com/search_newsSearches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section.
yahoo.com/search_newsSearches 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_newsSearches 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.
theguardian.com/search_newsSearches NPR-published articles by keyword, newest first or by best match, with optional publication dates, and returns each article's date, authors, section and summary.
npr.org/search_newsSearches CNBC-published articles by keyword, with optional publication date range, sort order and pagination. Excludes videos, wire stories and press releases.
cnbc.com/search_news