Get Google News top stories (v1) | Google News API

Returns the Top stories of a Google News edition, chosen by language and country, with related coverage for each story.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

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/top-headlines" \  -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"  }}