Al Jazeera API: Search news
Searches Al Jazeera articles by keyword, newest first or by relevance, with optional publication dates, and returns each article's headline, summary, time, authors and section. Searches up to the 100 matches Al Jazeera's search offers.
Unofficial. Not affiliated with or endorsed by Al Jazeera.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Page optional
page Result page to return, for example 1.
1 (default)
Whole number 1 or more.
- Sort optional
sort Order results by publication date or search relevance, for example newest.
newest (default)
One of
newest,most_relevant.- Query, required
query Words to search for, for example Tesla.
Tesla
- To Date optional
to_date Latest publication date (YYYY-MM-DD), inclusive, for example 2026-09-29. No limit if omitted.
Not set
- From Date optional
from_date Earliest publication date (YYYY-MM-DD), inclusive, for example 2026-01-01. No limit if omitted.
Not set
- Max Results optional
max_results Articles per page, for example 20.
20 (default)
Whole number from 1 to 50.
Input as JSON
{ "query": "Tesla"}Output
{ "articles": [ { "link": "https://www.aljazeera.com/news/2026/9/25/trump-hails-very-productive-talks-with-chinas-xi" , "authors": [ "Al Jazeera Staff" ], "section": "News", "summary": "Xi says China and US have a relationship of ‘strategic stability’ during three-day state visit to Washington, DC.", "headline": "Trump hails ‘very productive’ talks with China’s Xi Jinping", "published_at": "2026-09-25T15:19:34+00:00" }, { "link": "https://www.aljazeera.com/news/2026/9/25/trump-praises-us-china-friendship-at-state-dinner-with-xi-jinping" , "authors": [ "Al Jazeera" ], "section": "Economy", "summary": "The two superpowers seek greater dialogue despite differences over issues such as Iran, Taiwan, AI and trade.", "headline": "Trump praises US-China friendship at state dinner with Xi Jinping", "published_at": "2026-09-25T02:00:16+00:00" }, { "link": "https://www.aljazeera.com/economy/2026/9/22/20-countries-propose-global-oversight-body-to-manage-ai-dangers" , "authors": [ "John Power" ], "section": "Economy", "summary": "Countries including Germany, South Africa and Canada suggest international institution to set and enforce standards.", "headline": "20 countries propose global oversight body to manage AI dangers", "published_at": "2026-09-22T03:42:02+00:00" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"aljazeera.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": "aljazeera.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": "aljazeera.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 aljazeera.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 to return, for example 1." }, "sort": { "enum": [ "newest", "most_relevant" ], "type": "string", "default": "newest", "description": "Order results by publication date or search relevance, for example newest." }, "query": { "type": "string", "minLength": 1, "description": "Words to search for, for example Tesla." }, "to_date": { "type": "string", "description": "Latest publication date (YYYY-MM-DD), inclusive, for example 2026-09-29. No limit if omitted." }, "from_date": { "type": "string", "description": "Earliest publication date (YYYY-MM-DD), inclusive, for example 2026-01-01. No limit if omitted." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Articles per page, 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" }, "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "published_at": { "type": "string" } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
aljazeera.com/search_news- Returns
- headline, summary, published time, 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 aljazeera.com/search_news with the inputs above.
Ask your agent
- Find the latest Al Jazeera articles about the Sudan ceasefire talks, with headlines and authors
- Show me the most relevant news coverage of lithium mining in Chile published between 2025-03-01 and 2025-06-30
- What has been reported on Gaza humanitarian aid since 2025-10-01? List headlines, summaries and publish times, newest first
- Search Al Jazeera for stories on the Pakistan floods and give me the second page of results, 10 per page
- I need up to 50 recent articles mentioning OPEC oil output cuts, including section and link for each
See more
All Al Jazeera methodsLists current headlines from an Al Jazeera section page in page order, with summaries, bylines, publish times, images and article links. Pages further into the section through the site's feed when needed.
aljazeera.com/list_headlinesReads one public Al Jazeera article from its link, or from a headline (the best match of the site's own search), and returns its text and details; live blogs give their latest ten entries.
aljazeera.com/read_articleSearches 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_newsFinds 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.com/search_newsSearches CNN articles by keyword, with optional publication date range, sort order and pagination.
cnn.com/search_newsSearches public Wall Street Journal headlines and summaries by keyword, newest or most relevant first, optionally within publication dates; podcasts and live-coverage posts are left out.
wsj.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_news