---
title: "Trends topic autocomplete"
method: GET
path: "/v1/google/trends/autocomplete"
tags: ["Google Trends"]
---

# Trends topic autocomplete

`GET /v1/google/trends/autocomplete`

Return categorized topic entities from the Google Trends autocomplete API.

Unlike Google Search autocomplete (which returns flat keyword suggestions),
this endpoint returns Knowledge Graph entities each tagged with a `type`
and a machine identifier (`mid`) — the same data that powers the Trends
UI's "Search topic" picker. Each entry includes a direct link into the
Trends explore view for that topic.

## Query parameters

- `q` string, required — Query prefix to resolve into Trends topics
- `hl` string — Language code
- `tz` string — Timezone offset in minutes (Google format)

## Response `200`

Successful Response

- TrendsAutocompleteResponse — Response for GET /api/v1/trends/autocomplete.
  - `query` string, required
  - `results` TrendsAutocompleteItem[]
    - `title` string, required
    - `type` string, nullable
    - `mid` string, nullable — Knowledge Graph machine ID (e.g. '/m/02vx4')
    - `link` 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)