Actions7
News Search
AI-generatedSummary
Search for news articles using a specified query and optional filtering criteria, returning a list of news article results with metadata and optional additional page content extraction.
Inputs
- News Search Query (required) — The search terms to find news articles for.
- Maximum Results — Maximum number of news articles to return; DuckDuckGo may return fewer. Defaults to 10.
- Ranking Rules — Locally reorder or discard results based on domain or URL substrings; rules are applied in order to the fetched results before limiting to the maximum results.
- Region — Geographic region to target for news articles; affects the news source selection.
- Safe Search — Content filtering level (Strict, Moderate, Off) for news articles.
- Time Period — Time range for news articles (All time, past day, week, month, or year).
- Return Raw Results — Boolean flag to return the raw API response instead of processed results.
- Fetch Page Content — Boolean flag to fetch and extract main text from each article's page; this makes extra HTTP requests and is slower.
- Number of Results to Fetch — How many of the top results to fetch page content for if enabled (1-20).
- Max Content Length — Maximum characters of extracted page text to keep, or zero for no limit.
- Page Fetch Timeout — Maximum time in milliseconds to fetch each article page including redirects.
- Include Page Metadata — Include additional metadata fields (title, author, published date, excerpt, site name) when fetching page content.
- Error Handling — Strategy for handling errors: stop execution (Break on Error) or continue (Continue on Error).
- Debug Mode — Include detailed request and response info for troubleshooting.
- Cache Settings — Enable caching of search results and define cache Time-To-Live in seconds to improve performance for repeated queries.
Output shape
a list of news article search result objects, optionally enriched with page content and metadata, or the raw API response if requested.
Results are filtered and ranked locally according to ranking rules before limiting to the maximum number requested. Fetching page content applies only to the specified number of top results and may slow execution. Errors can be configured to break or continue. Caching improves performance by storing recent query results for the defined TTL.
Examples
Example 1: Basic news search
Provide a News Search Query string; uses default options to return up to 10 recent articles worldwide with safe search strict.
Example 2: Filtered and enriched search
Set region to United States, safe search moderate, past week time period, enable page content fetch for top 3 results with metadata, and apply ranking rules to boost specific domains.