Get Google News topic or publisher id
Get Google News topic or publisher ids matching a place, section, MID or name.
Headers
Get your API keyAPI key (`sfk_...`)
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
Place name to resolve, e.g. `London` or `San Francisco, CA`.
min 1 chars · max 200 chars
Section name to resolve: `WORLD`, `NATION`, `BUSINESS`, `TECHNOLOGY`, `ENTERTAINMENT`, `SPORTS`, `SCIENCE` or `HEALTH`.
one of: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH
Knowledge Graph MID to resolve, e.g. `/m/09nm_`.
pattern: ^\/[mg]\/[A-Za-z0-9_]+$
Name to resolve through Google News suggestions, e.g. `Taylor Swift` or `Reuters`. Matches are noisy; the candidates are returned.
min 1 chars · max 200 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 input that was resolved, with the others null.
The place name that was resolved, or null.
The section name that was resolved, or null.
The Knowledge Graph MID that was resolved, or null.
The name that was resolved through suggestions, or null.
The best match; null when nothing was resolved.
The resolved 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
Name of the entity, when it has one.
Knowledge Graph MID decoded from a topic id. Compare it to the MID asked for to see whether a place name fell back to the U.S. topic.
The Google News page for the resolved id.
Whether the result matches what was asked. False when a place name fell back to the U.S. topic, compared by id rather than by the local name; null when it cannot be compared (a section, a record with no name, or no suggestion match). An unknown place can resolve to the U.S. topic or be not_found, and this field tells which.
Icon for the match; null when the match has none.
Other matches from the suggestion box. Empty for place, section and MID resolution.
The resolved 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
Name of the entity, when it has one.
Knowledge Graph MID decoded from a topic id. Compare it to the MID asked for to see whether a place name fell back to the U.S. topic.
The Google News page for the resolved id.
Whether the result matches what was asked. False when a place name fell back to the U.S. topic, compared by id rather than by the local name; null when it cannot be compared (a section, a record with no name, or no suggestion match). An unknown place can resolve to the U.S. topic or be not_found, and this field tells which.
Icon for the match; null when the match has none.
The edition of this result.
Language and locale of the edition, e.g. `en-US`.
Two-letter country of the edition, e.g. `US`.
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/topics/resolve?query=technology" \
-H "x-api-key: YOUR_API_KEY"Responses
Resolve a place, section, MID or name.