Search Google News (v1) | Google News API

Returns up to 100 Google News articles for query, each with publisher, publication time and related coverage. Narrow by time with when; set resolve_links to true to fill url with the publisher link. A query with no matches returns an empty articles array.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

Search terms. Google News operators work inside it: site:reuters.com, "exact phrase", before:2026-01-01.

Length1 <= length <= 500

when?string

Only articles from the last hour, day, week, 30 days or year.

Value in

"1h"
"1d"
"7d"
"30d"
"1y"

language?string

Language of the edition, as a two-letter code such as en, de or ja.

Match^[a-z]{2,3}$

Default"en"

country?string

Country of the edition, as a two-letter code such as US, GB or DE.

Match^[A-Z]{2}$

Default"US"

limit?integer

Most articles to return, 1 to 100. With resolve_links the maximum is 20.

Range1 <= value <= 100

Default100

resolve_links?string

Set true to fill each article's url with the publisher's own link instead of null. Slower: up to about 15 seconds for 20 articles.

Default"false"

Value in

"true"
"false"

curl -X GET "https://example.com/v1/google-news/search?query=nvidia+earnings" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "string",    "when": "string",    "topic": "string",    "location": "string",    "language": "string",    "country": "string",    "feed_title": "string",    "count": 0,    "links_resolved": true,    "articles": [      {        "title": "string",        "link": "string",        "article_id": "string",        "url": "string",        "published_at": "string",        "source": {          "name": "string",          "url": "string"        },        "related": [          {            "title": "string",            "link": "string",            "article_id": "string",            "source": "string"          }        ]      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}