# NPR API: Search news

> Searches NPR-published articles by keyword, newest first or by best match, with optional publication dates, and returns each article's date, authors, section and summary.

Unofficial. Not affiliated with or endorsed by NPR.

- Page: https://fous.com/methods/npr.org/search-news
- Method: `npr.org/search_news`, version 1
- Website: npr.org
- Returns: headline, summary, published time, authors, section, article 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 | `1` | Results page, starting at 1, for example 2. Default 1. |
| `sort` | string | no |  | Order articles by newest publication or best match, for example newest. One of "newest", "most_relevant". Default "newest". |
| `query` | string | yes | `"Tesla"` | Words to search for, such as Tesla. |
| `to_date` | string | no |  | Latest publication date (YYYY-MM-DD), for example 2026-09-01. |
| `from_date` | string | no |  | Earliest publication date (YYYY-MM-DD), for example 2026-01-01. |
| `max_results` | integer | no | `50` | Articles per page, for example 20. Default 20. |

## Output

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

```json
{
  "page": 1,
  "query": "Tesla",
  "max_results": 50
}
```

Its output:

```json
{
  "articles": [
    {
      "authors": [
        "Scott Simon"
      ],
      "section": "Author Interviews",
      "summary": "NPR's Scott Simon talks with journalist Robert Kolker about his new book, \"The Vanishing Family.\" It's about a family with a high risk of frontotemporal dementia due to a genetic mutation.",
      "headline": "Award-winning journalist Robert Kolker talks about his book, 'The Vanishing Family'",
      "article_link": "https://www.npr.org/2026/09/26/nx-s1-5777570/award-winning-journalist-robert-kolker-talks-about-his-book-the-vanishing-family",
      "published_at": "2026-09-26T07:37:46-04:00"
    },
    {
      "authors": [
        "Jason DeRose"
      ],
      "section": "Religion",
      "summary": "The AI users included a conservative Christian in Texas, a witchcraft practitioner in Virginia and a Jewish man from California.",
      "headline": "A surprising number of Americans use AI for spiritual reasons. Here's what they told us",
      "article_link": "https://www.npr.org/2026/09/21/nx-s1-5944346/a-surprising-number-of-americans-use-ai-for-spiritual-reasons-heres-what-they-told-us",
      "published_at": "2026-09-25T15:22:49-04:00"
    },
    {
      "authors": [
        "The Associated Press"
      ],
      "section": "U.S. vs. China: Inside a great power rivalry",
      "summary": "A tech-heavy guest list, the fashion choices of those on it, who sat where and what was on the menu marked the softer — often and glitzier — details of diplomacy as Donald Trump threw a Thursday night state dinner honoring China's leader Xi Jinping.",
      "headline": "Trump's state dinner for Xi features sea bass and a long list of tech titans",
      "article_link": "https://www.npr.org/2026/09/25/g-s1-144973/trump-state-dinner-xi",
      "published_at": "2026-09-25T02:18:59-04: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":"npr.org/search_news","input":{"page":1,"query":"Tesla","max_results":50}}'
```

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 NPR articles about the Federal Reserve interest rate decision, with authors and section for each
- Show me news stories on wildfire smoke health effects published between 2025-06-01 and 2025-09-30, best matches first
- I need the second page of recent coverage mentioning Ukraine ceasefire talks, 30 articles per page
- What has NPR published on AI chatbots in schools since March 2025? Give headlines, summaries and links
- Pull the 10 most relevant public radio news pieces about the measles outbreak in Texas, including publish dates and bylines

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Results page, starting at 1, for example 2."
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order articles by newest publication or best match, for example newest."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search for, such as Tesla."
    },
    "to_date": {
      "type": "string",
      "description": "Latest publication date (YYYY-MM-DD), for example 2026-09-01."
    },
    "from_date": {
      "type": "string",
      "description": "Earliest publication date (YYYY-MM-DD), for example 2026-01-01."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Articles per 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",
          "article_link"
        ],
        "properties": {
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "section": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": "string"
          },
          "article_link": {
            "type": "string"
          },
          "published_at": {
            "type": "string",
            "description": "Article publication time with UTC offset."
          }
        }
      },
      "description": "NPR articles matching the search."
    }
  }
}
```

## See more

- [NPR API: List headlines](https://fous.com/methods/npr.org/list-headlines.md): Lists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links.
- [NPR API: Read article](https://fous.com/methods/npr.org/read-article.md): Reads an NPR article by its link or headline and returns its text and publication details. For live blogs, returns the displayed updates.
- [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.
- [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.
- [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.
- [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.
- [CNN API: Search news](https://fous.com/methods/cnn.com/search-news.md): Searches CNN articles by keyword, with optional publication date range, sort order and pagination.
- [wsj.com API: Search Wall Street Journal articles](https://fous.com/methods/wsj.com/search-news.md): Searches public Wall Street Journal headlines and summaries by keyword, newest or most relevant first, optionally within publication dates; podcasts and live-coverage posts are left out.
- [All NPR methods](https://fous.com/methods/npr.org.md)
