Search Google News
Input
query requiredSearch keywords, e.g. "anthropic". Google's search operators work here too (site:, intitle:, OR).
when optionalOptional recency filter, appended to the query as Google's own `when:` operator. Verified working with "1d" (past 24h, server-side filtered). Google's other documented units follow the same syntax: "1h", "7d", "1y". Note the site's own Date dropdown keeps displaying "Anytime" even when this operator is filtering — the filter is applied server-side regardless of that label. Omit for the site's inclusive "Anytime" default.
count optionalTarget number of articles. Google News loads ~10 more per scroll; the script scrolls until this many are collected or the list stops growing, so fewer may be returned for a narrow query.
Default: 20country optionalGoogle News `gl` edition country code, e.g. "US", "FR", "JP". Combined with `language` into the site's `ceid` edition parameter.
Default: "US"language optionalGoogle News `hl` interface/content language, e.g. "en-US", "fr", "ja".
Default: "en-US"Output
url requiredquery requiredThe full query sent, including the `when:` operator if one was supplied.
articles requiredEmpty array is a legitimate outcome: Google News renders "There are no items to show." for a query with no matches. A consent interstitial or any other non-results page raises an error instead, so an empty array always means the search genuinely matched nothing.
articleCount requiredexhausted optionalTrue when the list stopped growing before `count` was reached — i.e. these are all the results Google News has for this query, not a truncated page.
requestedCount optional