# Al Jazeera API: Read an article

> 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.

Unofficial. Not affiliated with or endorsed by Al Jazeera.

- Page: https://fous.com/methods/aljazeera.com/read-article
- Method: `aljazeera.com/read_article`, version 1
- Website: aljazeera.com
- Returns: headline, summary, authors, publication and update times, section, tags, main image and caption, paragraphs, word count, article link and ID
- 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 |
|---|---|---|---|---|
| `article` | string | yes | `"https://www.aljazeera.com/news/liveblog/2026/9/28/iran-war-live-tehran-warns-its-fully-prepared-for-war-amid-hormuz-te…` | The article link or headline, for example Iran touts Hormuz attacks as oil flows increase despite tensions. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "article": "https://www.aljazeera.com/news/liveblog/2026/9/28/iran-war-live-tehran-warns-its-fully-prepared-for-war-amid-hormuz-tensions"
}
```

Its output:

```json
{
  "tags": [
    "US-Israel war on Iran"
  ],
  "authors": [
    "Adam Hancock",
    "Mohammed R Mhawish",
    "Umut Uras"
  ],
  "section": "News",
  "summary": "These were the updates on the US-Israel war on Iran from Monday, September 28, 2026.",
  "headline": "Iran war updates: Trump says US officials met Iran war mediators",
  "article_id": "4993668",
  "paragraphs": [
    "Our coverage continues",
    "This live page is now closed, but our round-the-clock coverage of the US-Israel war on Iran, the fighting in Yemen, as well as Israel’s attacks on Gaza, the occupied West Bank and Lebanon continues.",
    "Go here for all the latest breaking news, updates and analysis."
  ],
  "updated_at": "2026-09-29T00:00:49+00:00",
  "word_count": 1223,
  "article_url": "https://www.aljazeera.com/news/liveblog/2026/9/28/iran-war-live-tehran-warns-its-fully-prepared-for-war-amid-hormuz-tensions",
  "published_at": "2026-09-28T00:00:00+00:00",
  "main_image_url": "https://www.aljazeera.com/wp-content/uploads/2026/09/2026-09-28T190103Z_1194885279_RC2ISNAOQG7U_RTRMADP_3_USA-TRUMP-STEEL-1790623091.jpg?resize=1920%2C1440",
  "main_image_caption": "[Kevin Lamarque/Reuters]",
  "full_text_available": true
}
```

## 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/read_article","input":{"article":"https://www.aljazeera.com/news/liveblog/2026/9/28/iran-war-live-tehran-warns-its-fully-prepared-for-war-amid-hormuz-tensions"}}'
```

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

- Pull the full text of the Al Jazeera piece at https://www.aljazeera.com/news/2024/3/12/gaza-ceasefire-talks-stall-as-ramadan-begins, including who wrote it and when it was last updated
- Can you get me the article titled "Sudan's army retakes key bridge in Khartoum"? I need the paragraphs, the tags, and the word count.
- What are the latest entries on Al Jazeera's live blog about the Russia-Ukraine war today?
- Find the story headlined "Iran touts Hormuz attacks as oil flows increase despite tensions" and give me its summary, author names, and main image caption
- I have this link: aljazeera.com/economy/2025/1/8/why-global-food-prices-are-rising-again — fetch the body text and tell me which section it's filed under and when it was published

## Input schema

```json
{
  "type": "object",
  "required": [
    "article"
  ],
  "properties": {
    "article": {
      "type": "string",
      "description": "The article link or headline, for example Iran touts Hormuz attacks as oil flows increase despite tensions."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "headline",
    "summary",
    "authors",
    "published_at",
    "updated_at",
    "section",
    "tags",
    "main_image_url",
    "main_image_caption",
    "paragraphs",
    "full_text_available",
    "word_count",
    "article_url",
    "article_id"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "authors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "section": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "headline": {
      "type": "string"
    },
    "article_id": {
      "type": [
        "string",
        "null"
      ],
      "x-fous-developer": true
    },
    "paragraphs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last update in ISO 8601 with timezone offset."
    },
    "word_count": {
      "type": "integer"
    },
    "article_url": {
      "type": "string"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publication date and time in ISO 8601 with timezone offset."
    },
    "main_image_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "main_image_caption": {
      "type": [
        "string",
        "null"
      ]
    },
    "full_text_available": {
      "type": "boolean"
    }
  },
  "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: 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.
- [The Guardian API: Read article](https://fous.com/methods/theguardian.com/read-article.md): Reads one public Guardian article by link or headline and returns its details and available full-text paragraphs. Live blogs return the latest entries shown on the page; some older articles may be unavailable.
- [CNN API: Read an article](https://fous.com/methods/cnn.com/read-article.md): Reads a CNN article by link or headline and returns its headline, summary, authors, dates, section, tags, main image and public paragraphs. Subscriber stories return only a brief public preview; live blogs include their entries.
- [BBC News API: Read article](https://fous.com/methods/bbc.com/read-article.md): Reads the text and details of a BBC News article from its link or headline. Live coverage pages return the latest entries available.
- [NPR API: Read article](https://fous.com/methods/npr.org/read-article.md): Reads an NPR article by its link or headline and returns its text and publication details. For live blogs, returns the displayed updates.
- [AP News API: Read article](https://fous.com/methods/apnews.com/read-article.md): Reads the full text and details of one public AP News article from its link or headline.
- [Yahoo API: Read article](https://fous.com/methods/yahoo.com/read-article.md): Reads a public Yahoo News article from its link or headline and returns its text and details. Headline matching uses Yahoo News search results.
- [All Al Jazeera methods](https://fous.com/methods/aljazeera.com.md)