List Google Trends places
List the places Google Trends explore requests accept.
Headers
Get your API keyAPI key (`sfk_...`)
Interface language, as Google calls `hl` (`en-US`, `de`, `ja`, `ar`). It localises names, dates and type text; it does not translate the queries.
pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})?$
Only the places of this country, e.g. `US`.
pattern: ^[A-Z]{2}$
Only places at this level: `country`, `subdivision` (states, provinces, regions) or `metro` (US Nielsen DMAs).
one of: country, subdivision, metro
Endpoint-specific response payload.
`found` when the filter matches at least one place; `not_found` when it matches none.
one of: found, not_found
The interface language the names use.
The country filter that was applied; null when none was.
The level filter that was applied; null when all levels were returned.
one of: country, subdivision, metro, null
Number of places in this response.
Flattened places: 250 countries, 3,130 subdivisions and 301 US metro areas when unfiltered.
Full place id: `US`, `US-CA` or `US-CA-807` (parent codes prefixed).
Place name, localised by language.
Country, subdivision or US Nielsen metro area.
one of: country, subdivision, metro
Parent place id; null for a country.
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-trends/geos?country=US&level=metro" \
-H "x-api-key: YOUR_API_KEY"Responses
Google Trends places.