Recent News Article Aggregator
Search and retrieve recent news articles from multiple sources. Supports topic-based search, category filtering, country/language targeting, and age limits.
Actions
search
Search for news articles by topic, category, country, and language.
Required Fields: None (all fields are optional; a bare search returns general US English news)
Optional Fields:
| Field | Type | Description |
|---|---|---|
topic | string | Search query. Supports operators: + (AND), ` |
news_type | string | "all_news" (default) for broad results or "top_stories" for major headlines only. |
categories | array of strings | Include only these categories. Options: general, science, sports, business, health, entertainment, tech, politics, food, travel. |
exclude_categories | array of strings | Exclude these categories. Same options as above. |
max_age_in_days | integer | Limit results to articles published within the past N days (minimum 1). |
country | string | Two-letter country code (default: "us"). |
language | string | Language code (default: "en"). |
Example — Search by topic:
{
"action": "search",
"topic": "artificial intelligence",
"max_age_in_days": 7
}
Example — Top stories in a category:
{
"action": "search",
"news_type": "top_stories",
"categories": ["business", "tech"]
}
Example — Exclude categories and target a country:
{
"action": "search",
"topic": "climate change",
"exclude_categories": ["sports", "entertainment"],
"country": "gb",
"language": "en"
}
Example — Crypto/finance topic (auto-detected):
{
"action": "search",
"topic": "bitcoin ETF approval"
}
Common Workflows
- Daily news briefing — Use
news_type: "top_stories"with no topic to get current headlines. - Topic monitoring — Provide a
topicwithmax_age_in_daysto track a subject over a rolling window. - Category-filtered research — Combine
categorieswith atopicto narrow results (e.g., health + "pandemic"). - International coverage — Set
countryandlanguageto retrieve region-specific articles. - Exclusion filtering — Use
exclude_categoriesto remove irrelevant results (e.g., exclude sports and entertainment for a business report).
Response Format
Each article in the response includes:
title— Article headlinedescription— Summary or snippeturl— Link to the full articleimage_url— Associated image (if available)source— Publishing source namepublished_at— Publication timestampcategories— Article categorieslanguage— Article language
Important Notes
- When no
topicis provided, results are based on category and region filters only. - Crypto-related topics (bitcoin, ethereum, blockchain, etc.) and financial/market topics (stocks, forex, inflation, etc.) are automatically routed to specialized news endpoints for better coverage.
- The
categoriesandexclude_categoriesfields accept one or more values from the fixed list of ten categories. - The
max_age_in_daysfield must be at least 1. - Default behavior returns US English news across all categories.







