> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/google-news/suggest>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-news/suggest.mdx>

---

# 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?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.

## Request

- **Endpoint:** `GET /v1/google-news/suggest`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by name
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/google-news/suggest/get)
- **Platform page:** [/platforms/google-news](https://www.socialfetch.dev/platforms/google-news)

## 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.