---
title: "Interest by region"
method: GET
path: "/v1/google/trends/regions"
tags: ["Google Trends"]
---

# Interest by region

`GET /v1/google/trends/regions`

Get interest by region for a search term.

Google's widget has a resolution hierarchy — you can't ask for
country-level data inside a specific country. Passing
``resolution=auto`` (the default) uses whatever resolution the
widget itself returned, which is always valid.

## Query parameters

- `q` string, required — Search term
- `geo` string — Geographic location
- `date` string
- `resolution` 'COUNTRY' | 'REGION' | 'DMA' | 'CITY' | 'auto' — Region granularity. `auto` (default) uses Google's widget default, which is `COUNTRY` for worldwide queries and `REGION` (state/province) for single-country queries. Overriding to `COUNTRY` when `geo` is set returns HTTP 400 from Google — use `REGION`, `DMA`, or `CITY` in that case.

## Response `200`

Successful Response

- TrendsRegionsResponse — Response for GET /api/v1/trends/regions.
  - `regions` TrendsRegionInterest[]
    - `region` string, required
    - `region_code` string, nullable
    - `value` integer
    - `max_value_index` integer
  - `query` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/versions/4a1ef8777baf/schema)