List Google News suggestions
List Google News topic and publisher suggestions matching a name.
Headers
Get your API keyAPI key (`sfk_...`)
Name to get Google News suggestions for, e.g. `Taylor Swift`.
min 1 chars · max 200 chars
Language and locale of the edition, e.g. `en-US`, `de`, `pt-BR` or `zh-Hant`. Default: `en-US`. The 400 response for an unsupported pair lists every supported pair.
min 2 chars · max 16 chars
Two-letter country of the edition, e.g. `US`, `GB` or `JP`. Default: `US`. Send it with `language`; an unsupported pair is rejected with every supported pair listed.
min 2 chars · max 2 chars
Endpoint-specific response payload.
`found` when the entity exists, including when it has no articles right now. `not_found` when the id does not exist.
one of: found, not_found
The name that was asked about.
The edition of this result.
Language and locale of the edition, e.g. `en-US`.
Two-letter country of the edition, e.g. `US`.
The top match; null when there was no topic or publisher match.
Topic or publication id.
`topic` for an entity, section or place topic; `publisher` for an outlet; `unknown` when the kind is not known.
one of: topic, publisher, unknown
Google News's own label, e.g. `Topic`, `Source` or `Search results`.
Suggestion name.
Icon for the match; null when the match has none.
Related topics the suggestion box listed. At most 50 are returned.
Topic id.
Topic name.
Google News path of the topic, e.g. `/topics/CAAq...`.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/google-news/suggest?query=Taylor%20Swift" \
-H "x-api-key: YOUR_API_KEY"Responses
Topic and publisher suggestions for a name.