News Search
AI-generatedSummary
Search news articles using a specified query with optional filters such as country, language, pagination, and safe search settings.
Inputs
- Query (required) — The search query term to find news articles. Cannot be empty, with a maximum of 400 characters and 50 words.
- Count — Number of news results to return, between 1 and 50. Actual results may be fewer. Use with offset for pagination.
- Additional Parameters — Optional filters and settings including country (2-character code), search language, user interface language, offset for pagination, spellcheck toggle, safe search level (off/moderate/strict), freshness of search results, enabling extra snippets, and custom Goggles URLs to influence ranking.
Output shape
a list of news search result items as JSON objects.
The number of results returned respects the 'Count' and 'Offset' parameters for pagination. Optional fields in results may vary depending on API response and enabled parameters like extra snippets and Goggles. Errors for individual items include contextual info if continuing on failure.