Social Fetch
Start for freeStart free
Google News hub

Google News Suggestions API

Turn a name into a topic or publisher id, with the related topics the suggestion box returns.

GET /v1/google-news/suggest

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/google-news/suggest?query=Taylor%20Swift returns lookupStatus, query, edition, top and topics. top is the best match with id, kind, type, name and iconUrl. topics holds the related topics, each with id, name and the path the suggestion came with.

Matches are prefix-like and can be noisy, which is why the top match and the related list are both returned. A Search results placeholder is reported as not_found: it is a search prompt, not a topic or publisher id. Use the id from top or topics with GET /v1/google-news/topics/{topicId} or GET /v1/google-news/publishers/{publicationId}.

For a place, section or Knowledge Graph MID, use GET /v1/google-news/topics/resolve instead. It can also resolve a name through the same suggestion box.

Google News Suggestions API FAQ

What is the difference between top and topics?

top is the single best match. topics is the related suggestion list. Both use the same ids, so either can feed the topic or publisher route.

Why is a match marked not_found?

The suggestion box answered with a search prompt rather than a topic or publisher. top is null and the search prompt is not returned as an id.

Why do the matches look noisy?

The suggestion box matches prefixes and related names, not exact titles. Compare name and kind before using an id in a production job.

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