---
title: "获取搜索推荐词/Get search suggestions"
method: GET
path: "/api/v1/youtube/web_v2/get_search_suggestions"
tags: ["YouTube-Web-V2-API"]
---

# 获取搜索推荐词/Get search suggestions

`GET /api/v1/youtube/web_v2/get_search_suggestions`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/youtube/web_v2/get_search_suggestions`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取YouTube搜索推荐词（自动补全）
- 类似于在YouTube搜索框输入时显示的推荐词

### 参数:
- keyword: 搜索关键词（必填）
- language: 语言代码（可选，默认 en）
  - en: 英语
  - zh-cn: 简体中文
  - ja: 日语
  - ko: 韩语
- region: 地区代码（可选，默认 US）
  - US: 美国
  - SG: 新加坡
  - CN: 中国
  - JP: 日本
  - KR: 韩国

### 返回数据包含:
- keyword: 搜索关键词
- suggestions: 推荐词列表（字符串数组）
- total_count: 推荐词数量

### 注意事项:
- 推荐词会根据语言和地区有所不同
- 通常返回 10-20 个推荐词
- 响应速度非常快（< 1秒）

### 价格:
- $0.0001 USD / 请求

# [English]
### Purpose:
- Get YouTube search suggestions (autocomplete)
- Similar to suggestions shown when typing in YouTube search box

### Parameters:
- keyword: Search keyword (required)
- language: Language code (optional, default en)
  - en: English
  - zh-cn: Simplified Chinese
  - ja: Japanese
  - ko: Korean
- region: Region code (optional, default US)
  - US: United States
  - SG: Singapore
  - CN: China
  - JP: Japan
  - KR: Korea

### Returns:
- keyword: Search keyword
- suggestions: Suggestions list (array of strings)
- total_count: Number of suggestions

### Notes:
- Suggestions vary by language and region
- Typically returns 10-20 suggestions
- Very fast response (< 1 second)

### Price:
- $0.0001 USD / request

### [示例/Example]
#### 获取推荐词: keyword = "Rick Astley"

## Query parameters

- `keyword` string, required: 搜索关键词/Search keyword
- `language` string: 语言代码/Language code (e.g., en, zh-cn, ja)
- `region` string: 地区代码/Region code (e.g., US, SG, CN, JP)

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-01** `50f9ec6e1cd3`: 2 info
  - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200`
  - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200`
- **2026-04-14** `ee5b7c9c88f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/youtube/web_v2/get_search_suggestions/get.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)