Skip to content

The Guardian API

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

theguardian.com (opens in a new tab)

Unofficial. Not affiliated with or endorsed by The Guardian.

Methods

3

  • Read article

    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.

    Returns headline, summary, authors, dates, section, tags, image, paragraphs, word count, URL

    Readtheguardian.com/read_article

  • List headlines

    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.

    Returns headline, summary, publication time, authors, section, image link, article link

    Readtheguardian.com/list_headlines

  • Search news

    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.

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

    Readtheguardian.com/search_news