Social Fetch
Start for freeStart free
Google News hub

Google News Article Link API

Turn article ids from search or a topic into the publisher's own URLs, up to ten at a time.

GET /v1/google-news/articles/resolve

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/google-news/articles/resolve?ids=… takes 1 to 10 article ids, comma-separated, and returns edition and results. Each result is { id, url }, in request order. Duplicates are dropped before the request, and one credit covers the whole batch.

The ids are the ones search, a topic, Headlines or a story already return. url is the publisher's article URL, or null when it is not available. A null URL is a completed answer, not a failure: keep the id and try again later if you need the link. One refused id does not fail the batch; it keeps its place with url: null, and the other ids still resolve.

Send language and country to choose the edition used for the resolution. The resolved pair is in edition.

Google News Article Link API FAQ

How many ids can I send?

Between 1 and 10 per request, comma-separated. One credit covers the whole batch, not each id.

Why is a url null?

The publisher URL for that id is not available at this moment. The id is still in results with its null URL, so your batch stays aligned.

What happens to duplicates?

Duplicates are dropped before the request. The returned order follows the ids you sent, with the duplicate removed.

Which edition is used?

Send a supported language and country pair. The pair used is returned in edition.

How many credits does it cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Google News endpoints