# The Guardian API: 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.

Unofficial. Not affiliated with or endorsed by The Guardian.

- Page: https://fous.com/methods/theguardian.com/search-news
- Method: `theguardian.com/search_news`, version 1
- Website: theguardian.com
- Returns: headline, summary, publication time, authors, section, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `page` | integer | no |  | Results page, for example 2. Default 1. |
| `sort` | string | no | `"most_relevant"` | Order matches by newest date or search relevance, for example newest. One of "newest", "most_relevant". Default "newest". |
| `query` | string | yes | `"Tesla"` | Search words, for example Tesla. |
| `to_date` | string | no | `"2026-09-29"` | Latest publication date (YYYY-MM-DD), for example 2026-09-29. |
| `from_date` | string | no | `"2026-09-20"` | Earliest publication date (YYYY-MM-DD), for example 2026-09-01. |
| `max_results` | integer | no | `3` | Maximum articles on a page, for example 20. Default 20. |

## Output

From a run on Oct 31, 2026. Its input:

```json
{
  "sort": "most_relevant",
  "query": "Tesla",
  "to_date": "2026-09-29",
  "from_date": "2026-09-20",
  "max_results": 3
}
```

Its output:

```json
{
  "articles": [
    {
      "link": "https://www.theguardian.com/technology/2026/sep/21/black-employees-accuse-tesla-fostering-discrimination",
      "authors": [
        "Dara Kerr"
      ],
      "section": "Technology",
      "summary": "Lawyers say Black employees at Tesla experienced ‘rampant racism’ that was left unchecked for years at their flagship factory in California",
      "headline": "Black Tesla employees accuse company of fostering racial discrimination in major trial",
      "published_at": "2026-09-21T23:20:34+00:00"
    },
    {
      "link": "https://www.theguardian.com/australia-news/2026/sep/24/beau-lamarre-condon-trial-surfboard-bag-double-murder-jesse-baird-luke-davies-ntwnfb",
      "authors": [
        "Kat Wong"
      ],
      "section": "Australia news",
      "summary": "Former NSW police officer has pleaded not guilty to murdering Jesse Baird and Luke Davies before concealing bodies in bags bought from sports store",
      "headline": "Beau Lamarre-Condon sized up surfboard bag against friend before allegedly murdering Sydney couple, court told",
      "published_at": "2026-09-24T10:22:44+00:00"
    },
    {
      "link": "https://www.theguardian.com/technology/2026/sep/25/trump-xi-ai-arms-race",
      "authors": [
        "David Smith"
      ],
      "section": "Technology",
      "summary": "Xi’s state visit to the US emphasized personal rapport with the US president, rather than substantial agreements to pause their respective countries’ AI arms race",
      "headline": "Trump and Chinese president Xi end summit without major agreement on AI",
      "published_at": "2026-09-25T22:11:52+00:00"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"theguardian.com/search_news","input":{"sort":"most_relevant","query":"Tesla","to_date":"2026-09-29","from_date":"2026-09-20","max_results":3}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find the latest Guardian articles about the UK junior doctors' strike, newest first, with headlines and authors
- What did the Guardian publish about Arctic sea ice between 2025-03-01 and 2025-03-31? Give me headline, section and publish time for each.
- Pull the most relevant news coverage of OpenAI's board shake-up, up to 10 articles with summaries and bylines
- Show me page 2 of recent articles mentioning Keir Starmer and the housing crisis, 30 per page
- I need news pieces on the Paris Olympics opening ceremony published from July 20 to July 31, 2024, sorted by relevance, including links and which section each ran in

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Results page, for example 2."
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order matches by newest date or search relevance, for example newest."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search words, for example Tesla."
    },
    "to_date": {
      "type": "string",
      "description": "Latest publication date (YYYY-MM-DD), for example 2026-09-29."
    },
    "from_date": {
      "type": "string",
      "description": "Earliest publication date (YYYY-MM-DD), for example 2026-09-01."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum articles on a page, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "articles"
  ],
  "properties": {
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "headline",
          "summary",
          "published_at",
          "authors",
          "section",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string",
            "format": "uri"
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "section": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": "string"
          },
          "published_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [The Guardian API: List headlines](https://fous.com/methods/theguardian.com/list-headlines.md): 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.
- [The Guardian API: Read article](https://fous.com/methods/theguardian.com/read-article.md): 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.
- [BBC News API: Search articles](https://fous.com/methods/bbc.com/search-news.md): Finds BBC News articles matching search words, newest first or by relevance, with publication time, authors, section and summary, optionally limited to a date range. Date filters and newest order apply to the first 180 search matches; older or less relevant matches may be missed.
- [Reuters API: Search news](https://fous.com/methods/reuters.com/search-news.md): Searches Reuters articles by keyword through Google News, with optional publication date range, order and page. Summaries and bylines are filled in when Reuters serves the article page.
- [The New York Times API: Search articles](https://fous.com/methods/nytimes.com/search-news.md): Searches New York Times article headlines and summaries by keyword, optionally within a date range, and returns matching articles with dates, authors, sections and links, newest or most relevant first.
- [Daily Mail API: Search news](https://fous.com/methods/dailymail.co.uk/search-news.md): Searches Daily Mail-published articles by keyword, newest first or by relevance, with optional publication dates and paging, and returns each article's headline, summary, time, authors and section. Covers up to the 200 matches Daily Mail search offers; syndicated wire stories are excluded.
- [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section.
- [Al Jazeera API: Search news](https://fous.com/methods/aljazeera.com/search-news.md): 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.
- [All The Guardian methods](https://fous.com/methods/theguardian.com.md)