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 optionalNumber of articles to return. Fewer come back when Google News has fewer results for the query; complete then says so.
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 requiredcomplete optionalTrue when these are all the results Google News has for this query: it sent no further page and count cut nothing. False when count stopped the list first.
requestedCount optional