Google News Publisher API

Q: Where does the publication id come from?

From `source.publicationId` on an article returned by search, a topic, Headlines or a story. It is not the outlet's domain or name.

Q: What if the article has no publication id?

`source.publicationId` is null on some article records. Search for the outlet name, or resolve it with `topics/resolve` and use the id it returns.

Q: Why is the publisher not_found?

The id is well formed but is not a publication. `publisher` is null, `articles` is empty and `streamStatus` is null. A topic id is not a publication id. A real outlet requested in the wrong edition is different: it is found with an empty `articles` list and `streamStatus: unavailable`, so send the outlet's own language and country.

One outlet's recent articles, using the publication id an article record already carries.

GET /v1/google-news/publishers/{publicationId}

1 credit Failed requests are free

Try in playground Full API docs

About this endpoint

GET /v1/google-news/publishers/{publicationId} returns lookupStatus, publisher, articles and edition. publisher has the id, name and tabs of the publication record, and articles holds its recent articles with url, ampUrl, image, source, authors, label and publishedAt where the record has them.

Take publicationId from an article's source.publicationId. Not every article record carries one; when it is null, search for the outlet name or resolve it through GET /v1/google-news/topics/resolve. Publisher streams are scoped to the edition: send the outlet's own language and country. A real outlet requested in another edition returns lookupStatus: found, its publisher record, articles: [] and streamStatus: unavailable, which tells you the edition is the problem; an id that is not a publication at all returns not_found with publisher: null.

The stream holds up to 50 articles and the answer returns at most 100. There is no page parameter.

Google News Publisher API FAQ

Where does the publication id come from?

From source.publicationId on an article returned by search, a topic, Headlines or a story. It is not the outlet's domain or name.

What if the article has no publication id?

source.publicationId is null on some article records. Search for the outlet name, or resolve it with topics/resolve and use the id it returns.

Why is the publisher not_found?

The id is well formed but is not a publication. publisher is null, articles is empty and streamStatus is null. A topic id is not a publication id. A real outlet requested in the wrong edition is different: it is found with an empty articles list and streamStatus: unavailable, so send the outlet's own language and country.

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.

About this endpoint

Google News Publisher API FAQ

Other Google News endpoints