How do I connect The Guardian to Lodol?

Authenticate The Guardian once from your workspace and every action and trigger it supports becomes available to drop into a workflow. There is no glue code to write or maintain.

All integrations

The Guardian

News

Read The Guardian with its own Open Platform API: every article, video, gallery and live blog it has published since 1999, plus the tags, sections and regional editions behind them. Search the archive by words, phrase, section, tag, journalist or date range, follow a subject over a rolling window for a scheduled workflow, count how much is being written about it and compare several subjects side by side, pull one article's full text and pictures, follow a live blog update by update, and read the editors' picks and most-viewed lists from any edition's front page.

Get Started Browse all integrations

17 actions

Actions

Steps your workflow can run in The Guardian.

Search articlesSearch everything the Guardian has published since 1999: more than two million articles, plus video, galleries and live blogs, with every filter the Content API offers. Words and phrases, which part of the article to match them in, sections, tags, a published-between range, language, newsroom, star rating and reuse rights. Each result comes back with its headline, byline, summary, image, word count and tags, and optionally the full article text.

Search recent articlesSearch Guardian content published inside a window that moves with the clock (the last 6 hours, the last day, the last week), counted back from the moment the step runs. This is the search to put on a schedule: a fixed date range would return the same articles on every run, while this one always looks at what is new.

Get articles in a sectionGet the latest content from one section of the Guardian: Politics, Environment, Football, Technology and around eighty others, newest first. Pick the section from the dropdown, which is filled from the Guardian's own list for your connection.

Get articles by a journalistGet everything one Guardian journalist has written, newest first. Type their name ('George Monbiot') and it is matched against the Guardian's contributor list for you; a contributor tag such as profile/georgemonbiot works too and skips the lookup.

Find articles by referenceFind Guardian content tied to an identifier you already have: the ISBN of a book, the IMDb id of a film, a MusicBrainz id, an Opta or PA football fixture. Guardian reviews carry these, so this is how to go from a catalogue of your own to the Guardian's coverage of it.

Count articlesCount how much the Guardian has published on a subject, and name the newest piece. It costs a single request whether the answer is three articles or thirty thousand, so it is the cheap check to branch a workflow on: alert someone when coverage of your organisation spikes, or skip the rest of the run when there is nothing new.

Compare topicsCompare how much the Guardian is writing about several subjects (two to five of them) over the same window, ranked, each with its share of the combined coverage and its newest headline. Use it for share of voice against competitors, or to see which of several stories is getting the attention.

Get next articlesContinue a search past the point where page numbers stop working. The Guardian caps how deep 'Page' can go; hand this the id of the last article you saw, with the same search words and ordering, and it returns the ones that come after it. Repeat until fewer articles come back than you asked for.

Get an articleGet everything the Guardian holds for one article: the full text, the headline and standfirst, the byline and every contributor, the tags, the pictures and video with their captions and credits, the word count, and the rights that say whether it may be republished. Paste a theguardian.com link or use an id from an earlier step.

Get related articlesGet the Guardian's own 'more on this story' list for an article: the related content it generates from the article's tags, plus the story package editors assemble by hand for a running story. Use it to follow a thread rather than search for one.

Get editors' picksGet the articles Guardian editors have put at the top of a front page, in their running order, for a regional edition (UK, US, Australia, Europe, International) or for one section. This is the site as people actually see it, which no search reproduces: it is chosen by people, not by date or relevance.

Get most-viewed articlesGet what Guardian readers are actually reading right now, most-read first, for a regional edition or for one section. Editors' picks say what the Guardian thinks matters; this says what people are opening.

Get live blog updatesGet the individual posts inside a Guardian live blog: the newest few, the first few, or only the key events editors have flagged. A live blog's article text is one long run of every post ever made; this returns them one at a time, each with its own timestamp, so a workflow watching a running story can act on what is new.

Search tagsSearch the tags every piece of Guardian content is filed under, more than 70,000 of them: subjects, journalists, series, tones, media types. Tags are how the Guardian's archive is filtered, so this is where the ids the other actions take come from: search 'Monbiot' among contributors, or 'apple' among keywords, and use the id it returns.

Get a tagGet one Guardian tag with its own front page: what editors have chosen to lead it, the newest content filed under it, and the tag's description or, for a journalist, their biography and byline picture. A search by tag returns whatever is newest; this returns what the Guardian is leading with.

List sectionsList every section the Guardian groups its content into, around eighty of them, from Politics and Environment to Football and Food, each with the id the section filters take and the regional editions it appears in.

List editionsList the Guardian's regional front pages (UK, US, Australia, Europe and International) with the id each one takes. Use it to confirm what is available before reading an edition's editors' picks or most-viewed list.