Skip to content

Al Jazeera API

Al Jazeera (aljazeera.com) has 3 public methods: list headlines, search news and read an article. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

aljazeera.com (opens in a new tab)

Unofficial. Not affiliated with or endorsed by Al Jazeera.

Methods

3

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

    Returns headline, summary, published_at, authors, section, image_link, article_link

    Readaljazeera.com/list_headlines

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

    Returns headline, summary, published time, authors, section, link

    Readaljazeera.com/search_news

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

    Returns headline, summary, authors, publication and update times, section, tags, main image and caption, paragraphs, word count, article link and ID

    Readaljazeera.com/read_article