# 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. - Page: https://fous.com/methods/aljazeera.com/list-headlines - Method: `aljazeera.com/list_headlines`, version 1 - Website: aljazeera.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 | `"Middle East"` | News section, for example Middle East. One of "top stories", "Middle East", "Africa", "Asia", "US and Canada", "Europe", "economy", "sport", "opinion". Default "top stories". | | `max_results` | integer | no | `20` | Maximum stories to return, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "section": "Middle East", "max_results": 20 } ``` Its output: ```json { "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" } ] } ``` ## 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":"aljazeera.com/list_headlines","input":{"section":"Middle East","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 - 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. ## Input schema ```json { "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 ```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" ], "description": "Article publication time in ISO 8601 with an offset, if shown." } }, "additionalProperties": false }, "description": "Headlines in page order." } }, "additionalProperties": false } ``` ## See more - [Al Jazeera API: Search news](https://fous.com/methods/aljazeera.com/search-news.md): 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. - [Al Jazeera API: Read an article](https://fous.com/methods/aljazeera.com/read-article.md): Reads 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. - [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. - [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. - [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. - [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. - [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. - [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. - [All Al Jazeera methods](https://fous.com/methods/aljazeera.com.md)