NPR (National Public Radio)
Overview
Major U.S. public media news outlet. Public Algolia search index provides full article content including text, author, date, topics, and audio availability.
Workflows
Search for articles on a topic
searchArticles(query) → objectID, title, bodyTextgetArticle(objectID) → full bodyText, topics, bylines
Get today's top stories
getTopStories() → objectID, title, displayDategetArticle(objectID) → full bodyText, topics, image
Research a topic
searchArticles(query, hitsPerPage: 20) → objectID, title, topics- Filter by topic using
filters: "type:story AND topics:\"Health\"" for section-specific results
getArticle(objectID) → full bodyText, bylines
Operations
| Operation |
Intent |
Key Input |
Key Output |
Notes |
| searchArticles |
find articles by keyword |
query |
objectID, title, bodyText, bylines, displayDate |
entry point, paginated (page 0-indexed) |
| getArticle |
full article content |
objectID ← searchArticles/getTopStories |
bodyText (full), title, bylines, topics, image |
body is plain text |
| getTopStories |
latest front page stories |
— |
objectID, title, bodyText, displayDate, topics |
entry point, pre-filtered to homepage stories |
Quick Start
# Search for articles
openweb npr exec searchArticles '{"query": "artificial intelligence"}'
# Get a specific article (use objectID from search results)
openweb npr exec getArticle '{"objectID": "nx-s1-5777587"}'
# Get latest top stories
openweb npr exec getTopStories '{}'
# Search with pagination
openweb npr exec searchArticles '{"query": "economy", "hitsPerPage": 20, "page": 1}'
1---2name: npr3description: NPR (National Public Radio)4---5# NPR (National Public Radio)67## Overview8Major U.S. public media news outlet. Public Algolia search index provides full article content including text, author, date, topics, and audio availability.910## Workflows1112### Search for articles on a topic131. `searchArticles(query)` → `objectID`, `title`, `bodyText`142. `getArticle(objectID)` → full `bodyText`, `topics`, `bylines`1516### Get today's top stories171. `getTopStories()` → `objectID`, `title`, `displayDate`182. `getArticle(objectID)` → full `bodyText`, `topics`, `image`1920### Research a topic211. `searchArticles(query, hitsPerPage: 20)` → `objectID`, `title`, `topics`222. Filter by topic using `filters: "type:story AND topics:\"Health\""` for section-specific results233. `getArticle(objectID)` → full `bodyText`, `bylines`2425## Operations2627| Operation | Intent | Key Input | Key Output | Notes |28|-----------|--------|-----------|------------|-------|29| searchArticles | find articles by keyword | query | objectID, title, bodyText, bylines, displayDate | entry point, paginated (page 0-indexed) |30| getArticle | full article content | objectID ← searchArticles/getTopStories | bodyText (full), title, bylines, topics, image | body is plain text |31| getTopStories | latest front page stories | — | objectID, title, bodyText, displayDate, topics | entry point, pre-filtered to homepage stories |3233## Quick Start3435```bash36# Search for articles37openweb npr exec searchArticles '{"query": "artificial intelligence"}'3839# Get a specific article (use objectID from search results)40openweb npr exec getArticle '{"objectID": "nx-s1-5777587"}'4142# Get latest top stories43openweb npr exec getTopStories '{}'4445# Search with pagination46openweb npr exec searchArticles '{"query": "economy", "hitsPerPage": 20, "page": 1}'47```
spike-faye-lei