# 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. - Page: https://fous.com/methods/aljazeera.com/search-news - Method: `aljazeera.com/search_news`, version 1 - Website: aljazeera.com - Returns: headline, summary, published time, authors, section, 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 | |---|---|---|---|---| | `page` | integer | no | | Result page to return, for example 1. Default 1. | | `sort` | string | no | | Order results by publication date or search relevance, for example newest. One of "newest", "most_relevant". Default "newest". | | `query` | string | yes | `"Tesla"` | Words to search for, for example Tesla. | | `to_date` | string | no | | Latest publication date (YYYY-MM-DD), inclusive, for example 2026-09-29. No limit if omitted. | | `from_date` | string | no | | Earliest publication date (YYYY-MM-DD), inclusive, for example 2026-01-01. No limit if omitted. | | `max_results` | integer | no | | Articles per page, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "query": "Tesla" } ``` Its output: ```json { "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" } ] } ``` ## 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/search_news","input":{"query":"Tesla"}}' ``` 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 - 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 ## Input schema ```json { "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 ```json { "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" } } } } } } ``` ## See more - [Al Jazeera API: List headlines](https://fous.com/methods/aljazeera.com/list-headlines.md): 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. - [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. - [Reuters API: Search news](https://fous.com/methods/reuters.com/search-news.md): Searches 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. - [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. - [CNN API: Search news](https://fous.com/methods/cnn.com/search-news.md): Searches CNN articles by keyword, with optional publication date range, sort order and pagination. - [wsj.com API: Search Wall Street Journal articles](https://fous.com/methods/wsj.com/search-news.md): Searches 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. - [The Guardian API: Search news](https://fous.com/methods/theguardian.com/search-news.md): Searches 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. - [NPR API: Search news](https://fous.com/methods/npr.org/search-news.md): Searches 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. - [All Al Jazeera methods](https://fous.com/methods/aljazeera.com.md)