---
title: "Google Trends — unified search"
method: GET
path: "/v1/google/trends/search"
tags: ["Google Trends"]
---

# Google Trends — unified search

`GET /v1/google/trends/search`

Unified Google Trends dispatcher. Pick the shape via `data_type`.

## Query parameters

- `q` string, required — Search term(s). Up to 5 comma-separated terms for TIMESERIES / GEO_MAP; single term for GEO_MAP_0 / RELATED_TOPICS / RELATED_QUERIES. Also accepts a topic MID.
- `data_type` 'TIMESERIES' | 'GEO_MAP' | 'GEO_MAP_0' | 'RELATED_TOPICS' | 'RELATED_QUERIES' — Dispatch on: TIMESERIES (interest over time), GEO_MAP (compared breakdown, multi-query), GEO_MAP_0 (interest by region, single query), RELATED_TOPICS (top + rising topics), RELATED_QUERIES (top + rising queries).
- `geo` string — Country / region code (e.g. US, GB, US-CA).
- `date` string — Time range.
- `cat` integer — Category filter ID (0 = all).
- `gprop` string — Property filter: "" (web), "images", "news", "froogle", "youtube".
- `region` string, nullable — Geo resolution for GEO_MAP / GEO_MAP_0: COUNTRY / REGION / DMA / CITY. Omit to use the widget's own default.
- `language` string, nullable — Alias for `hl`. Defaults to en-US.
- `tz` string — Timezone offset in minutes.

## Response `200`

Successful Response

- TrendsSearchResponse — Unified response for GET /api/v1/trends/search. A single endpoint that dispatches on ``data_type`` (TIMESERIES, GEO_MAP, GEO_MAP_0, RELATED_TOPICS, RELATED_QUERIES). Only the field set relevant to the requested ``data_type`` is populated; others stay at their empty defaults.
  - `query` string, required
  - `data_type` string, required
  - `timeline` TrendsTimelinePoint[]
    - `date` string, required
    - `timestamp` integer, nullable
    - `values` TrendsTimelineValue[]
      - `query` string, required
      - `value` integer, required
      - `extracted_value` integer, nullable
  - `averages` TrendsTimelineValue[]
    - `query` string, required
    - `value` integer, required
    - `extracted_value` integer, nullable
  - `regions` TrendsRegionInterest[]
    - `region` string, required
    - `region_code` string, nullable
    - `value` integer
    - `max_value_index` integer
  - `top_topics` TrendsRelatedItem[]
    - `title` string, required
    - `value` string, nullable
    - `link` string, nullable
    - `topic_id` string, nullable
    - `topic_type` string, nullable
  - `rising_topics` TrendsRelatedItem[]
    - `title` string, required
    - `value` string, nullable
    - `link` string, nullable
    - `topic_id` string, nullable
    - `topic_type` string, nullable
  - `top_queries` TrendsRelatedItem[]
    - `title` string, required
    - `value` string, nullable
    - `link` string, nullable
    - `topic_id` string, nullable
    - `topic_type` string, nullable
  - `rising_queries` TrendsRelatedItem[]
    - `title` string, required
    - `value` string, nullable
    - `link` string, nullable
    - `topic_id` string, nullable
    - `topic_type` string, nullable

## 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)