Google News

List Google News sections

List Google News sections for an edition, with their topic ids.

GET/v1/google-news/sections
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
languagestringquery

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

countrystringquery

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

Response fields
11

Endpoint-specific response payload.

The edition of this result.

dataeditionlanguage
string

Language and locale of the edition, e.g. `en-US`.

dataeditioncountry
string

Two-letter country of the edition, e.g. `US`.

Navigation sections in Google News order.

datasections[]id
string

Section topic id.

datasections[]name
string

Section name in the edition's language.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/google-news/sections?language=en-US&country=US" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Navigation sections for an edition.