The Guardian

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.

Actions

Action	What it does
Compare topics	Compare 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.
Count articles	Count how much the Guardian has published on a subject, and name the newest piece.
Find articles by reference	Find 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.
Get a tag	Get 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.
Get an article	Get 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.
Get articles by a journalist	Get everything one Guardian journalist has written, newest first.
Get articles in a section	Get the latest content from one section of the Guardian: Politics, Environment, Football, Technology and around eighty others, newest first.
Get editors' picks	Get 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.
Get live blog updates	Get the individual posts inside a Guardian live blog: the newest few, the first few, or only the key events editors have flagged.
Get most-viewed articles	Get what Guardian readers are actually reading right now, most-read first, for a regional edition or for one section.
Get next articles	Continue a search past the point where page numbers stop working.
Get related articles	Get 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.
List editions	List the Guardian's regional front pages (UK, US, Australia, Europe and International) with the id each one takes.
List sections	List 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.
Search articles	Search 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.
Search recent articles	Search 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.
Search tags	Search the tags every piece of Guardian content is filed under, more than 70,000 of them: subjects, journalists, series, tones, media types.

Compare topics

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

Inputs

TopicstopicslistRequired: The subjects to compare: between two and five. Each one is a search in its own right, so phrases and AND/OR/NOT work here too.
How far backwindowtext: How recent an article has to be, counted back from the moment the step runs, so a workflow on a schedule keeps looking at fresh news instead of at one fixed date.One of: 1h (Last hour), 6h (Last 6 hours), 12h (Last 12 hours), 24h (Last 24 hours), 2d (Last 2 days), 7d (Last 7 days), 14d (Last 14 days), 30d (Last 30 days), 90d (Last 3 months), 365d (Last year). Default: 24h.
Sectionssectionslist: Optional. Only include content from these sections of the Guardian. An article matches if it is in any one of them. The list comes from your connection.

Outputs

from_datetext: The start of the window, in UTC
leading_topictext: The most covered topic
requests_usednumber: How many Guardian requests this spent: one per topic
sectionstext: The section filter that was applied
to_datetext: The end of the window, in UTC
topic_countnumber: How many topics were compared
topicslist: The topics, most covered first
total_resultsnumber: The combined article count across the topics
windowtext: The window compared
window_labeltext: That window in words

Example output

{
  "from_date": "2026-07-20T09:00:00Z",
  "leading_topic": "inflation",
  "requests_used": 2,
  "sections": "business",
  "to_date": "2026-08-19T09:00:00Z",
  "topic_count": 2,
  "topics": [
    {
      "newest_headline": "Inflation falls again as food prices ease",
      "newest_published_at": "2026-08-19T06:00:00Z",
      "newest_url": "https://www.theguardian.com/business/2026/aug/19/example",
      "share_percent": 61.3,
      "topic": "inflation",
      "total_results": 214
    },
    {
      "newest_headline": "Jobless total edges up in the north-east",
      "newest_published_at": "2026-08-18T10:30:00Z",
      "newest_url": "https://www.theguardian.com/business/2026/aug/18/example",
      "share_percent": 38.7,
      "topic": "unemployment",
      "total_results": 135
    }
  ],
  "total_results": 349,
  "window": "30d",
  "window_label": "Last 30 days"
}

Count articles

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

Inputs

Search forquerytext: Words to look for anywhere in the article. Put a phrase in double quotes for an exact match ("mitochondrial donation"), and combine terms with AND, OR and NOT, for example: debate AND (economy OR immigration). Optional: leave it empty to take everything that matches the other filters.
Sectionssectionslist: Optional. Only include content from these sections of the Guardian. An article matches if it is in any one of them. The list comes from your connection.
Tagstagslist: Optional. Only include content carrying these tags. A tag is the path part of a Guardian tag page, such as technology/apple or profile/georgemonbiot; use the Search tags action to find them.
How far backwindowtext: Optional. Count only what was published inside a window counted back from the moment the step runs. Overrides the two dates below when it is set.One of: 1h (Last hour), 6h (Last 6 hours), 12h (Last 12 hours), 24h (Last 24 hours), 2d (Last 2 days), 7d (Last 7 days), 14d (Last 14 days), 30d (Last 30 days), 90d (Last 3 months), 365d (Last year).
Published on or afterfrom_datedate: Optional. Only include content published on or after this date. The Guardian's archive goes back to 1999.
Published on or beforeto_datedate: Optional. Only include content published on or before this date.

Outputs

from_datetext: The start of the period counted
newest_headlinetext: The headline of the most recent match
newest_published_attext: When it was published, in UTC
newest_section_nametext: The section it appeared in
newest_urltext: Its link on theguardian.com
querytext: The search that ran
sectionstext: The section filter that was applied
tagstext: The tag filter that was applied
to_datetext: The end of the period counted
total_resultsnumber: How many articles match
windowtext: The relative window used, if one was
window_labeltext: That window in words

Example output

{
  "from_date": "2026-08-12T09:00:00Z",
  "newest_headline": "AI firms face new rules on training data",
  "newest_published_at": "2026-08-19T08:12:00Z",
  "newest_section_name": "Technology",
  "newest_url": "https://www.theguardian.com/technology/2026/aug/19/example",
  "query": "artificial intelligence",
  "sections": null,
  "tags": null,
  "to_date": "2026-08-19T09:00:00Z",
  "total_results": 66,
  "window": "7d",
  "window_label": "Last 7 days"
}

Find articles by reference

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

Inputs

Referencereferencetext: The identifier to look for. Give it on its own, 9780718178949, and pick its type below, or give the full form isbn/9780718178949. Leave it empty to list everything carrying a reference of the chosen type.
Reference typereference_typetext: Which scheme the reference belongs to. Also usable on its own, to list everything carrying one.One of: isbn (ISBN (a book)), imdb (IMDb id (a film or show)), musicbrainz (MusicBrainz id (an artist or release)), musicbrainzgenre (MusicBrainz genre), r1-film (Guardian film id), author (Author id), bisac-prefix (BISAC subject prefix), opta-football-match (Opta football match), opta-football-team (Opta football team), opta-football-tournament (Opta football tournament), and 11 more.
Pagepagenumber: Which page of results to return. Page 1 is the first. Past a few thousand results the Guardian stops paging by number; use the Get next articles action from there.At least 1. Default: 1.
Results per pagepage_sizenumber: How many results to return, from 1 to 50.From 1 to 50. Default: 10.

Outputs

article_countnumber: How many articles came back on this page
articleslist: The matching articles
has_moretrue/false: Whether another page follows
order_bytext: The ordering that was applied
pagenumber: Which page this is
page_sizenumber: How many results are on it
referencetext: The reference that was looked for
reference_typetext: The scheme it belongs to
total_pagesnumber: How many pages there are
total_resultsnumber: How many results match overall, not just on this page

Example output

{
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "has_more": true,
  "order_by": "newest",
  "page": 1,
  "page_size": 10,
  "reference": "isbn/9780718178949",
  "reference_type": "isbn",
  "total_pages": 43,
  "total_results": 428
}

Get a tag

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

Inputs

TagtagtextRequired: The tag to read: its id, or its page link on theguardian.com. Use the Search tags action to find one.
Results per pagepage_sizenumber: How many results to return, from 1 to 50.From 1 to 50. Default: 10.

Outputs

article_countnumber: How many articles came back on this page
articleslist: The matching articles
has_moretrue/false: Whether another page follows
lead_article_countnumber: How many lead articles came back
lead_articleslist: What editors have chosen to lead this tag
order_bytext: The ordering that was applied
pagenumber: Which page this is
page_sizenumber: How many results are on it
tagobject: The tag itself
tag_idtext: The tag that was read
total_pagesnumber: How many pages there are
total_resultsnumber: How many results match overall, not just on this page

Example output

{
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "has_more": true,
  "lead_article_count": 1,
  "lead_articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "order_by": "newest",
  "page": 1,
  "page_size": 10,
  "tag": {
    "api_url": "https://content.guardianapis.com/technology/apple",
    "bio": null,
    "description": "Guardian coverage of Apple",
    "id": "technology/apple",
    "image_url": null,
    "references": [],
    "section_id": "technology",
    "section_name": "Technology",
    "title": "Apple",
    "type": "keyword",
    "url": "https://www.theguardian.com/technology/apple"
  },
  "tag_id": "technology/apple",
  "total_pages": 43,
  "total_results": 428
}

Get an article

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

Inputs

ArticlearticletextRequired: The article to read. Paste its theguardian.com link, or use the id an earlier step returned.
Include the article textinclude_bodytrue/false: Include the full text of the article. On by default; turn it off when you only want the metadata.Default: true.
Include images and videoinclude_mediatrue/false: Add the pictures, video and audio published with each article, each with its caption and credit.Default: false.

Outputs

articleobject: The article and everything held about it
article_idtext: The id that was read

Example output

{
  "article": {
    "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
    "body_html": null,
    "body_text": null,
    "byline": "Fiona Harvey",
    "character_count": null,
    "contributors": [
      "Fiona Harvey"
    ],
    "first_published_at": "2026-08-19T11:04:22Z",
    "headline": "UK heatwave breaks August records for a third year running",
    "id": "environment/2026/aug/19/uk-heatwave-records-climate",
    "is_commentable": true,
    "is_live_blog": false,
    "keywords": [
      "Climate crisis",
      "Heatwaves",
      "Environment"
    ],
    "language": "en",
    "last_modified_at": "2026-08-19T14:12:09Z",
    "media": [],
    "pillar_name": "News",
    "production_office": "UK",
    "publication": "theguardian.com",
    "published_at": "2026-08-19T11:04:22Z",
    "references": [],
    "rights": [],
    "section_id": "environment",
    "section_name": "Environment",
    "series": [],
    "short_url": "https://www.theguardian.com/p/x5f6x9",
    "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
    "star_rating": null,
    "summary": "Temperatures passed 38C in south-east England on Tuesday.",
    "tags": [
      {
        "api_url": "https://content.guardianapis.com/environment/climate-crisis",
        "bio": null,
        "description": "The Guardian's climate coverage",
        "id": "environment/climate-crisis",
        "image_url": null,
        "references": [],
        "section_id": "environment",
        "section_name": "Environment",
        "title": "Climate crisis",
        "type": "keyword",
        "url": "https://www.theguardian.com/environment/climate-crisis"
      }
    ],
    "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
    "type": "article",
    "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
    "word_count": 812
  },
  "article_id": "environment/2026/aug/19/uk-heatwave-records-climate"
}

Get articles by a journalist

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

Inputs

JournalistcontributortextRequired: The journalist's name as the Guardian spells it, or their contributor tag. Use the Search tags action with the Contributor type if you are not sure.
Only articles mentioningquerytext: Optional. Narrow the results to articles containing these words.
Order results byorder_bytext: How to order the results. The Guardian defaults to best match when you search for words and to newest first when you do not.One of: newest (Newest first), oldest (Oldest first), relevance (Best match first).
Pagepagenumber: Which page of results to return. Page 1 is the first. Past a few thousand results the Guardian stops paging by number; use the Get next articles action from there.At least 1. Default: 1.
Results per pagepage_sizenumber: How many results to return, from 1 to 50.From 1 to 50. Default: 10.
Include the article textinclude_bodytrue/false: Add the full text of every article to the results. Useful when a later step summarises or classifies them; leave it off to keep the results small.Default: false.

Outputs

article_countnumber: How many articles came back on this page
articleslist: The matching articles
contributortext: The contributor tag the search ran against
contributor_nametext: The name the Guardian holds for them, when a name was looked up
has_moretrue/false: Whether another page follows
order_bytext: The ordering that was applied
pagenumber: Which page this is
page_sizenumber: How many results are on it
total_pagesnumber: How many pages there are
total_resultsnumber: How many results match overall, not just on this page

Example output

{
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "contributor": "profile/georgemonbiot",
  "contributor_name": "George Monbiot",
  "has_more": true,
  "order_by": "newest",
  "page": 1,
  "page_size": 10,
  "total_pages": 43,
  "total_results": 428
}

Get articles in a section

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

Inputs

SectionsectiontextRequired: The Guardian section to read. The list comes from your connection.
Only articles mentioningquerytext: Optional. Narrow the results to articles containing these words.
Order results byorder_bytext: How to order the results. The Guardian defaults to best match when you search for words and to newest first when you do not.One of: newest (Newest first), oldest (Oldest first), relevance (Best match first).
Pagepagenumber: Which page of results to return. Page 1 is the first. Past a few thousand results the Guardian stops paging by number; use the Get next articles action from there.At least 1. Default: 1.
Results per pagepage_sizenumber: How many results to return, from 1 to 50.From 1 to 50. Default: 10.
Include the article textinclude_bodytrue/false: Add the full text of every article to the results. Useful when a later step summarises or classifies them; leave it off to keep the results small.Default: false.

Outputs

article_countnumber: How many articles came back on this page
articleslist: The matching articles
has_moretrue/false: Whether another page follows
order_bytext: The ordering that was applied
pagenumber: Which page this is
page_sizenumber: How many results are on it
sectiontext: The section that was read
total_pagesnumber: How many pages there are
total_resultsnumber: How many results match overall, not just on this page

Example output

{
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "has_more": true,
  "order_by": "newest",
  "page": 1,
  "page_size": 10,
  "section": "environment",
  "total_pages": 43,
  "total_results": 428
}

Get editors' picks

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

Inputs

Sectionsectiontext: Optional. A Guardian section, if you want that section's front page rather than an edition's. Leave it empty to use the edition below.
Editioneditiontext: Which regional front page to read. Ignored when a section is chosen above.One of: international, uk, us, au (Australia), europe. Default: international.
How manypage_sizenumber: How many articles to return, from 1 to 50.From 1 to 50. Default: 10.

Outputs

article_countnumber: How many picks came back
articleslist: The picks, in the order editors set
is_sectiontrue/false: True when a section was read, false for an edition
scopetext: The section or edition that was read

Example output

{
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "is_section": false,
  "scope": "uk"
}

Get live blog updates

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

Inputs

Live blogarticletextRequired: The live blog to read. Paste its theguardian.com link, or use an id from an earlier step, such as a search result whose type is 'liveblog'.
Which updatesupdatestext: Which part of the live blog to return. Key events are the handful editors have marked as the story's turning points.One of: latest (Latest updates), oldest (First updates), key_events (Key events only). Default: latest.
How many updateslimitnumber: How many updates to return, from 1 to 50.From 1 to 50. Default: 10.

Outputs

article_idtext: The live blog that was read
headlinetext: The live blog's headline
is_live_blogtrue/false: False when the id turned out to be an ordinary article, which has no updates
total_updatesnumber: How many the live blog holds in total
update_countnumber: How many updates came back
updateslist: The updates, newest first unless you asked otherwise
updates_viewtext: Which slice was asked for
urltext: Its link on theguardian.com

Example output

{
  "article_id": "football/live/2026/aug/23/premier-league-live",
  "headline": "Premier League: Saturday's matches \u2013 live",
  "is_live_blog": true,
  "total_updates": 83,
  "update_count": 1,
  "updates": [
    {
      "contributors": [],
      "html": "<p>That is the end of a remarkable afternoon.</p>",
      "id": "6a8b35428f08582f5353262d",
      "is_key_event": true,
      "is_pinned": false,
      "is_published": true,
      "last_modified_at": "2026-08-23T18:03:31Z",
      "published_at": "2026-08-23T18:03:31Z",
      "text": "That is the end of a remarkable afternoon.",
      "title": "Full time"
    }
  ],
  "updates_view": "latest",
  "url": "https://www.theguardian.com/football/live/2026/aug/23/premier-league-live"
}

Get most-viewed articles

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

Inputs

Sectionsectiontext: Optional. A Guardian section, if you want that section's front page rather than an edition's. Leave it empty to use the edition below.
Editioneditiontext: Which regional front page to read. Ignored when a section is chosen above.One of: international, uk, us, au (Australia), europe. Default: international.
How manypage_sizenumber: How many articles to return, from 1 to 50.From 1 to 50. Default: 10.

Outputs

article_countnumber: How many came back
articleslist: The most-read articles, most-read first
is_sectiontrue/false: True when a section was read, false for an edition
scopetext: The section or edition that was read

Example output

{
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "is_section": true,
  "scope": "technology"
}

Get next articles

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

Inputs

Continue afterafter_articletextRequired: The last article you have already seen: its id or its theguardian.com link. Chain the 'last_article_id' this action returns straight back into it to walk through a whole result set.
Search forquerytext: The same words the original search used. The Guardian needs them again to know which result set to continue.
Order results byorder_bytext: How to order the results. The Guardian defaults to best match when you search for words and to newest first when you do not.One of: newest (Newest first), oldest (Oldest first), relevance (Best match first).
Results per pagepage_sizenumber: How many results to return, from 1 to 50.From 1 to 50. Default: 10.

Outputs

after_articletext: The article the results continue from
article_countnumber: How many articles came back on this page
articleslist: The matching articles
has_moretrue/false: Whether another page follows
last_article_idtext: The id of the last article here; feed it back in to get the next batch
order_bytext: The ordering that was applied
pagenumber: Which page this is
page_sizenumber: How many results are on it
querytext: The search that ran
reached_the_endtrue/false: True when fewer articles came back than were asked for, meaning there are no more
total_pagesnumber: How many pages there are
total_resultsnumber: How many results match overall, not just on this page

Example output

{
  "after_article": "food/2026/jul/04/peperonata-sausages-recipe",
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "has_more": true,
  "last_article_id": "food/2026/jun/20/glamorgan-sausages-recipe",
  "order_by": "newest",
  "page": 1,
  "page_size": 10,
  "query": "sausages",
  "reached_the_end": false,
  "total_pages": 43,
  "total_results": 428
}

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

Inputs

ArticlearticletextRequired: The article to read. Paste its theguardian.com link, or use the id an earlier step returned.
How manypage_sizenumber: How many articles to return, from 1 to 50.From 1 to 50. Default: 10.

Outputs

articleobject: That article itself
article_countnumber: How many related articles came back
article_idtext: The article the lists belong to
articleslist: Content the Guardian relates to it
story_packagelist: The editor-assembled package, when the story has one
story_package_countnumber: How many articles are in that package

Example output

{
  "article": {
    "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
    "body_html": null,
    "body_text": null,
    "byline": "Fiona Harvey",
    "character_count": null,
    "contributors": [
      "Fiona Harvey"
    ],
    "first_published_at": "2026-08-19T11:04:22Z",
    "headline": "UK heatwave breaks August records for a third year running",
    "id": "environment/2026/aug/19/uk-heatwave-records-climate",
    "is_commentable": true,
    "is_live_blog": false,
    "keywords": [
      "Climate crisis",
      "Heatwaves",
      "Environment"
    ],
    "language": "en",
    "last_modified_at": "2026-08-19T14:12:09Z",
    "media": [],
    "pillar_name": "News",
    "production_office": "UK",
    "publication": "theguardian.com",
    "published_at": "2026-08-19T11:04:22Z",
    "references": [],
    "rights": [],
    "section_id": "environment",
    "section_name": "Environment",
    "series": [],
    "short_url": "https://www.theguardian.com/p/x5f6x9",
    "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
    "star_rating": null,
    "summary": "Temperatures passed 38C in south-east England on Tuesday.",
    "tags": [
      {
        "api_url": "https://content.guardianapis.com/environment/climate-crisis",
        "bio": null,
        "description": "The Guardian's climate coverage",
        "id": "environment/climate-crisis",
        "image_url": null,
        "references": [],
        "section_id": "environment",
        "section_name": "Environment",
        "title": "Climate crisis",
        "type": "keyword",
        "url": "https://www.theguardian.com/environment/climate-crisis"
      }
    ],
    "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
    "type": "article",
    "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
    "word_count": 812
  },
  "article_count": 1,
  "article_id": "environment/2026/aug/19/uk-heatwave-records-climate",
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "story_package": [],
  "story_package_count": 0
}

List editions

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

Inputs

Search forquerytext: Optional. Only editions matching this. Leave it empty for all five.

Outputs

edition_countnumber: How many editions came back
editionslist: The Guardian's regional editions
total_resultsnumber: How many the Guardian reports overall

Example output

{
  "edition_count": 1,
  "editions": [
    {
      "api_url": "https://content.guardianapis.com/uk",
      "code": "UK",
      "id": "uk",
      "name": "UK",
      "path": "uk",
      "title": "new guardian uk front page",
      "url": "https://www.theguardian.com/uk"
    }
  ],
  "total_results": 5
}

List sections

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

Inputs

Search forquerytext: Optional. Only sections matching this. Leave it empty for all of them.

Outputs

section_countnumber: How many sections came back
sectionslist: The Guardian's sections
total_resultsnumber: How many the Guardian reports overall

Example output

{
  "section_count": 1,
  "sections": [
    {
      "api_url": "https://content.guardianapis.com/environment",
      "editions": [
        {
          "code": "default",
          "id": "environment",
          "title": "Environment",
          "url": "https://www.theguardian.com/environment"
        }
      ],
      "id": "environment",
      "title": "Environment",
      "url": "https://www.theguardian.com/environment"
    }
  ],
  "total_results": 1
}

Search articles

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

Inputs

Search forquerytext: Words to look for anywhere in the article. Put a phrase in double quotes for an exact match ("mitochondrial donation"), and combine terms with AND, OR and NOT, for example: debate AND (economy OR immigration). Optional: leave it empty to take everything that matches the other filters.
Search inquery_fieldslist: Optional. Which parts of an article the words have to appear in. Leave it empty to search all of them, which is usually what you want; narrowing to the headline finds articles that are about a subject rather than ones that merely mention it.One or more of: headline, standfirst, trailText (Summary), byline, body (Article text), thumbnail (Image caption).
Sectionssectionslist: Optional. Only include content from these sections of the Guardian. An article matches if it is in any one of them. The list comes from your connection.
Tagstagslist: Optional. Only include content carrying these tags. A tag is the path part of a Guardian tag page, such as technology/apple or profile/georgemonbiot; use the Search tags action to find them.
Match tagstag_matchtext: Whether an article has to carry every tag above, or just one of them.One of: all (All of them), any (Any of them). Default: all.
Published on or afterfrom_datedate: Optional. Only include content published on or after this date. The Guardian's archive goes back to 1999.
Published on or beforeto_datedate: Optional. Only include content published on or before this date.
Dates refer touse_datetext: Which date the published-between filter is measured against. An article that has been updated has several.One of: published (When it was last published), first-publication (When it was first published), newspaper-edition (When it appeared in the newspaper), last-modified (When it was last updated). Default: published.
Languagelanguagetext: Optional. Only include content written in this language. Almost everything the Guardian publishes is in English.One of: en (English), fr (French), es (Spanish), de (German), ar (Arabic), ru (Russian), zh (Chinese), ja (Japanese).
Newsroomproduction_officetext: Optional. Only include content produced by this Guardian newsroom.One of: uk (London (UK)), us (New York (US)), aus (Sydney (Australia)).
Star ratingstar_ratingnumber: Optional. Only include reviews given this many stars, from 1 to 5.From 1 to 5.
Reuse rightsrightstext: Optional. Only include content carrying this permission; use it when the results are going to be republished.One of: syndicatable, subscription-databases (Available to subscription databases), developer-community (Available to the developer community).
Order results byorder_bytext: How to order the results. The Guardian defaults to best match when you search for words and to newest first when you do not.One of: newest (Newest first), oldest (Oldest first), relevance (Best match first).
Order by which dateorder_datetext: Which date newest/oldest ordering uses. Only matters for content that has been updated or that appeared in the newspaper on a different day.One of: published (When it was published online), newspaper-edition (When it appeared in the newspaper), last-modified (When it was last updated). Default: published.
Pagepagenumber: Which page of results to return. Page 1 is the first. Past a few thousand results the Guardian stops paging by number; use the Get next articles action from there.At least 1. Default: 1.
Results per pagepage_sizenumber: How many results to return, from 1 to 50.From 1 to 50. Default: 10.
Include the article textinclude_bodytrue/false: Add the full text of every article to the results. Useful when a later step summarises or classifies them; leave it off to keep the results small.Default: false.
Include images and videoinclude_mediatrue/false: Add the pictures, video and audio published with each article, each with its caption and credit.Default: false.

Outputs

article_countnumber: How many articles came back on this page
articleslist: The matching articles
from_datetext: The earliest publication date asked for
has_moretrue/false: Whether another page follows
order_bytext: The ordering that was applied
pagenumber: Which page this is
page_sizenumber: How many results are on it
querytext: The search that ran
sectionstext: The section filter that was applied
tagstext: The tag filter that was applied
to_datetext: The latest publication date asked for
total_pagesnumber: How many pages there are
total_resultsnumber: How many results match overall, not just on this page

Example output

{
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "from_date": "2026-08-01",
  "has_more": true,
  "order_by": "newest",
  "page": 1,
  "page_size": 10,
  "query": "climate",
  "sections": "environment",
  "tags": null,
  "to_date": null,
  "total_pages": 43,
  "total_results": 428
}

Search recent articles

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

Inputs

Search forquerytext: Words to look for anywhere in the article. Put a phrase in double quotes for an exact match ("mitochondrial donation"), and combine terms with AND, OR and NOT, for example: debate AND (economy OR immigration). Optional: leave it empty to take everything that matches the other filters.
How far backwindowtext: How recent an article has to be, counted back from the moment the step runs, so a workflow on a schedule keeps looking at fresh news instead of at one fixed date.One of: 1h (Last hour), 6h (Last 6 hours), 12h (Last 12 hours), 24h (Last 24 hours), 2d (Last 2 days), 7d (Last 7 days), 14d (Last 14 days), 30d (Last 30 days), 90d (Last 3 months), 365d (Last year). Default: 24h.
Sectionssectionslist: Optional. Only include content from these sections of the Guardian. An article matches if it is in any one of them. The list comes from your connection.
Tagstagslist: Optional. Only include content carrying these tags. A tag is the path part of a Guardian tag page, such as technology/apple or profile/georgemonbiot; use the Search tags action to find them.
Order results byorder_bytext: How to order the results. The Guardian defaults to best match when you search for words and to newest first when you do not.One of: newest (Newest first), oldest (Oldest first), relevance (Best match first).
Results per pagepage_sizenumber: How many results to return, from 1 to 50.From 1 to 50. Default: 10.
Include the article textinclude_bodytrue/false: Add the full text of every article to the results. Useful when a later step summarises or classifies them; leave it off to keep the results small.Default: false.

Outputs

article_countnumber: How many articles came back on this page
articleslist: The matching articles
from_datetext: The start of the window, in UTC
has_moretrue/false: Whether another page follows
order_bytext: The ordering that was applied
pagenumber: Which page this is
page_sizenumber: How many results are on it
querytext: The search that ran
sectionstext: The section filter that was applied
tagstext: The tag filter that was applied
to_datetext: The end of the window, in UTC
total_pagesnumber: How many pages there are
total_resultsnumber: How many results match overall, not just on this page
windowtext: The window that was asked for
window_labeltext: That window in words, e.g. 'Last 7 days'

Example output

{
  "article_count": 1,
  "articles": [
    {
      "api_url": "https://content.guardianapis.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "body_html": null,
      "body_text": null,
      "byline": "Fiona Harvey",
      "character_count": null,
      "contributors": [
        "Fiona Harvey"
      ],
      "first_published_at": "2026-08-19T11:04:22Z",
      "headline": "UK heatwave breaks August records for a third year running",
      "id": "environment/2026/aug/19/uk-heatwave-records-climate",
      "is_commentable": true,
      "is_live_blog": false,
      "keywords": [
        "Climate crisis",
        "Heatwaves",
        "Environment"
      ],
      "language": "en",
      "last_modified_at": "2026-08-19T14:12:09Z",
      "media": [],
      "pillar_name": "News",
      "production_office": "UK",
      "publication": "theguardian.com",
      "published_at": "2026-08-19T11:04:22Z",
      "references": [],
      "rights": [],
      "section_id": "environment",
      "section_name": "Environment",
      "series": [],
      "short_url": "https://www.theguardian.com/p/x5f6x9",
      "standfirst": "Met Office says the run of hot summers is the clearest signal yet",
      "star_rating": null,
      "summary": "Temperatures passed 38C in south-east England on Tuesday.",
      "tags": [
        {
          "api_url": "https://content.guardianapis.com/environment/climate-crisis",
          "bio": null,
          "description": "The Guardian's climate coverage",
          "id": "environment/climate-crisis",
          "image_url": null,
          "references": [],
          "section_id": "environment",
          "section_name": "Environment",
          "title": "Climate crisis",
          "type": "keyword",
          "url": "https://www.theguardian.com/environment/climate-crisis"
        }
      ],
      "thumbnail_url": "https://media.guim.co.uk/example/500.jpg",
      "type": "article",
      "url": "https://www.theguardian.com/environment/2026/aug/19/uk-heatwave-records-climate",
      "word_count": 812
    }
  ],
  "from_date": "2026-08-12T09:00:00Z",
  "has_more": true,
  "order_by": "newest",
  "page": 1,
  "page_size": 10,
  "query": "artificial intelligence",
  "sections": null,
  "tags": null,
  "to_date": "2026-08-19T09:00:00Z",
  "total_pages": 43,
  "total_results": 428,
  "window": "7d",
  "window_label": "Last 7 days"
}

Search tags

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

Inputs

Search forquerytext: Words to look for in the tag. Matches anywhere in it, so 'green' finds Green party as well as green energy.
Name starts withstarts_withtext: Optional. Only tags whose name begins with this. Use it when you know the exact name ('George Monbiot') and want that one tag rather than everything mentioning it.
Tag typetag_typetext: Optional. Only tags of this kind. Contributor finds journalists, keyword finds subjects, series finds columns and podcasts.One of: keyword (Keyword (a subject)), contributor (Contributor (a journalist)), series (Series (a column or podcast)), blog, tone (Tone (feature, obituary, review…)), type (Type (article, video, gallery…)), publication, newspaper-book (Newspaper book), newspaper-book-section (Newspaper book section), campaign, paid-content (Paid content), tracking.
Sectionssectionslist: Optional. Only include content from these sections of the Guardian. An article matches if it is in any one of them. The list comes from your connection.
Pagepagenumber: Which page of results to return. Page 1 is the first. Past a few thousand results the Guardian stops paging by number; use the Get next articles action from there.At least 1. Default: 1.
Results per pagepage_sizenumber: How many results to return, from 1 to 50.From 1 to 50. Default: 10.

Outputs

has_moretrue/false: Whether another page follows
pagenumber: Which page this is
page_sizenumber: How many results are on it
tag_countnumber: How many tags came back on this page
tag_typetext: The type filter that was applied
tagslist: The matching tags
total_pagesnumber: How many pages there are
total_resultsnumber: How many results match overall, not just on this page

Example output

{
  "has_more": false,
  "page": 1,
  "page_size": 10,
  "tag_count": 1,
  "tag_type": "keyword",
  "tags": [
    {
      "api_url": "https://content.guardianapis.com/technology/apple",
      "bio": null,
      "description": "Guardian coverage of Apple",
      "id": "technology/apple",
      "image_url": null,
      "references": [],
      "section_id": "technology",
      "section_name": "Technology",
      "title": "Apple",
      "type": "keyword",
      "url": "https://www.theguardian.com/technology/apple"
    }
  ],
  "total_pages": 1,
  "total_results": 5
}

ActionsCopy Anchor Link

Compare topicsCopy Anchor Link

Inputs

Outputs

Count articlesCopy Anchor Link

Inputs

Outputs

Find articles by referenceCopy Anchor Link

Inputs

Outputs

Get a tagCopy Anchor Link

Inputs

Outputs

Get an articleCopy Anchor Link

Inputs

Outputs

Get articles by a journalistCopy Anchor Link

Inputs

Outputs

Get articles in a sectionCopy Anchor Link

Inputs

Outputs

Get editors' picksCopy Anchor Link

Inputs

Outputs

Get live blog updatesCopy Anchor Link

Inputs

Outputs

Get most-viewed articlesCopy Anchor Link

Inputs

Outputs

Get next articlesCopy Anchor Link

Inputs

Outputs

Get related articlesCopy Anchor Link

Inputs

Outputs

List editionsCopy Anchor Link

Inputs

Outputs

List sectionsCopy Anchor Link

Inputs

Outputs

Search articlesCopy Anchor Link

Inputs

Outputs

Search recent articlesCopy Anchor Link

Inputs

Outputs

Search tagsCopy Anchor Link

Inputs

Outputs

On this page

Actions

Compare topics

Count articles

Find articles by reference

Get a tag

Get an article

Get articles by a journalist

Get articles in a section

Get editors' picks

Get live blog updates

Get most-viewed articles

Get next articles

Get related articles

List editions

List sections

Search articles

Search recent articles

Search tags