Google News Search API

GET /v1/google-news/search?query=… returns one window of results with query, title, edition, articles and page. Send language and country to pick the edition. when takes a recent window such as 1h, 7d or 1y; after and before take real YYYY-MM-DD dates and cannot be combined with when.

The query string accepts the operators the edition understands: quotes for a phrase, site:, intitle:, source:, OR and -term. The response echoes the effective expression in query, including the time window (for example openai when:1h), and title contains the same expression. Each article carries id, title, publishedAt, source, googleUrl and datePrecision, so you can store the results without another call.

The first request returns the ranked Google News results, about 100 articles. When page.hasMore is true, send page.nextCursor as cursor while keeping the same query and edition. Without a date range the first cursor covers today's Pacific day, then each later cursor one older day, up to 100 items per window. With an after and before range, the first cursor covers the last day of that range, then earlier days down to after. A busier window is cut short and page.windowFull is true, so you can tell a complete window from a truncated one. A first request with after, before or when already has a date bound, and it says so too. The walk stops after seven empty days or at your after/when floor. page.nextBefore is the next window's exclusive before: date. A query with no matches returns articles: [], not an error.