# The Guardian API

> 3 public methods for The Guardian (theguardian.com), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by The Guardian.

- Page: https://fous.com/methods/theguardian.com

## Methods

### [Read article](https://fous.com/methods/theguardian.com/read-article.md)

`theguardian.com/read_article`, read. 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

### [List headlines](https://fous.com/methods/theguardian.com/list-headlines.md)

`theguardian.com/list_headlines`, read. 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

### [Search news](https://fous.com/methods/theguardian.com/search-news.md)

`theguardian.com/search_news`, read. 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