Al Jazeera API: List headlines
Lists 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.
Unofficial. Not affiliated with or endorsed by Al Jazeera.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Section optional
section News section, for example Middle East.
Middle East
One of
top stories,Middle East,Africa,Asia,US and Canada,Europe,economy,sport,opinion. Defaulttop stories.- Max Results optional
max_results Maximum stories to return, for example 20.
20
Whole number from 1 to 50. Default
20.
Input as JSON
{ "section": "Middle East", "max_results": 20}Output
{ "stories": [ { "authors": [ "Simon Speakman Cordall" ], "section": "Middle East", "summary": "Israel’s election heats up over ultra-Orthodox conscription debate, reflecting deep societal and political divides.", "headline": "Ultra-Orthodox conscription debate ignites Israel’s election battleground", "image_link": "https://www.aljazeera.com/wp-content/uploads/2026/10/ap_6ac7969144612-1791465105.jpg" , "article_link": "https://www.aljazeera.com/news/2026/10/23/ultra-orthodox-conscription-debate-ignites-israels-election-battleground" , "published_at": "2026-10-23T09:03:39+00:00" }, { "authors": [ "Nils Adler" ], "section": "Middle East", "summary": "With emergency stocks at multidecade lows, analysts say the world may have only a month or two if Hormuz shuts again.", "headline": "Are global oil reserves sufficient to withstand renewed US-Iran war?", "image_link": "https://www.aljazeera.com/wp-content/uploads/2026/10/AFP__20260618__B7HW7UM__v1__HighRes__IranUsIsraelWarTransportHormuz-1792534509.jpg" , "article_link": "https://www.aljazeera.com/news/2026/10/23/are-global-oil-reserves-sufficient-to-withstand-renewed-us-iran-war" , "published_at": "2026-10-23T07:37:12+00:00" }, { "authors": [], "section": "Middle East", "summary": "Support crucial from 47-nation AFC’s president, who was critic of Gianni Infantino over failed private investment plan.", "headline": "FIFA President Infantino’s re-election endorsed in U-turn by Asian football", "image_link": "https://www.aljazeera.com/wp-content/uploads/2026/10/2026-10-23T050723Z_933890040_RC2S8OA67QQI_RTRMADP_3_SOCCER-FIFA-ASIA-1792733641.jpg" , "article_link": "https://www.aljazeera.com/sports/2026/10/23/asian-football-endorses-infantino-re-election-as-fifa-president" , "published_at": "2026-10-23T06:11:27+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/list_headlines","input":{"section":"Middle East","max_results":20}}' # 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/list_headlines" , "input": { "section": "Middle East", "max_results": 20 }})# 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/list_headlines" , "input": { "section": "Middle East", "max_results": 20 } }), 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/list_headlines# with {"section":"Middle East","max_results":20}"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": [], "properties": { "section": { "enum": [ "top stories", "Middle East", "Africa", "Asia", "US and Canada", "Europe", "economy", "sport", "opinion" ], "type": "string", "default": "top stories", "description": "News section, for example Middle East." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum stories to return, for example 20." } }, "additionalProperties": false}Output schema
{ "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" ], "description": "Article publication time in ISO 8601 with an offset, if shown." } }, "additionalProperties": false }, "description": "Headlines in page order." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
aljazeera.com/list_headlines- Returns
- headline, summary, published_at, authors, section, image_link, article_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/list_headlines with the inputs above.
Ask your agent
- Show me the latest headlines from the Middle East section, up to 15 stories with bylines and publish times.
- What are the top stories right now? Give me 25 headlines with summaries and article links.
- Pull the newest Africa news stories from Al Jazeera, including images and authors.
- I need the latest economy headlines from aljazeera.com, maybe 10 of them with their publish dates.
- List the most recent sport stories and opinion pieces, around 30 items with links to the articles.
See more
All Al Jazeera methodsSearches 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.
aljazeera.com/search_newsReads 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_articleLists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link.
bbc.com/list_headlinesLists 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.
cnn.com/list_headlinesLists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order.
reuters.com/list_headlinesLists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links.
npr.org/list_headlinesLists 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.
theguardian.com/list_headlinesLists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed.
theverge.com/list_headlines