> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取搜索推荐词

> 获取YouTube搜索推荐词（自动补全）
类似于在YouTube搜索框输入时显示的推荐词

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

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">3 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">每次请求</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 让 AI 帮你写调用代码</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。</p>
  </div>

  <div className="mt-4">
    <button type="button" className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50" onClick={() => navigator.clipboard.writeText("我想调用 KeyAPI 接口：GET https://api.keyapi.ai/v1/youtube/get_search_suggestions\n\n请帮我编写调用代码，并包含必要的错误处理、参数校验和响应处理逻辑。\n\n接口信息：\n\nEndpoint: GET https://api.keyapi.ai/v1/youtube/get_search_suggestions\n\nDescription: YouTube 的「搜索建议」接口用于按关键词、地区或筛选条件检索数据，返回匹配结果、核心指标和分页信息。适用于视频分析、频道研究、评论监测和内容发现。常用必填参数包括 keyword。\n\nRequired Headers:\n--header 'Authorization: Bearer <YOUR_API_KEY>'\n\nParameters:\n- keyword (Required): 搜索关键词. Example: Rick Astley\n- language (Optional): 语言代码. Example: en\n- region (Optional): 地区或国家代码，例如 US、GB、DE. Example: US\n\nExample Response:\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": {\n    \"keyword\": \"Rick Astley\",\n    \"suggestions\": [\n      \"rick astley never gonna give you up\",\n      \"rick astley\",\n      \"rick astley together forever\",\n      \"rick astley pink pony club\",\n      \"rick astley foo fighters\",\n      \"rick astley never gonna give you up lyrics\",\n      \"rick astley interview\",\n      \"rick astley cry for help\",\n      \"rick astley songs\",\n      \"rick astley never gonna give you up live\",\n      \"rick astley take me to your heart\",\n      \"rick astley she wants to dance with me\",\n      \"rick astley it would take a strong strong man\",\n      \"rick astley whenever you need somebody\"\n    ],\n    \"total_count\": 14\n  },\n  \"requestId\": \"aca97c0b-6216-4ba0-b502-df42fb0da1d7\"\n}\n\n请根据以上信息给出可直接运行的示例代码。")}>
      ✨ 复制给 AI
    </button>
  </div>
</div>


## OpenAPI

````yaml zh/youtube.zh.openapi.json GET /v1/youtube/get_search_suggestions
openapi: 3.0.1
info:
  title: YouTube API 中文文档
  description: YouTube API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security: []
tags: []
paths:
  /v1/youtube/get_search_suggestions:
    get:
      tags: []
      summary: 获取搜索推荐词
      description: |-
        获取YouTube搜索推荐词（自动补全）
        类似于在YouTube搜索框输入时显示的推荐词

        注意事项:
        推荐词会根据语言和地区有所不同
        通常返回 10-20 个推荐词
        响应速度非常快（< 1秒）
      parameters:
        - name: keyword
          in: query
          description: 搜索关键词
          required: true
          example: Rick Astley
          schema:
            type: string
            example: Rick Astley
        - name: language
          in: query
          description: |-
            语言代码（可选，默认 en）
            可选值
            en: 英语
            zh-cn: 简体中文
            ja: 日语
            ko: 韩语
          required: false
          example: en
          schema:
            type: string
            default: en
        - name: region
          in: query
          description: |-
            地区代码（可选，默认 US）
            US: 美国
            SG: 新加坡
            CN: 中国
            JP: 日本
            KR: 韩国
          required: false
          example: US
          schema:
            type: string
            default: US
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  keyword: Rick Astley
                  suggestions:
                    - rick astley never gonna give you up
                    - rick astley
                    - rick astley together forever
                    - rick astley pink pony club
                    - rick astley foo fighters
                    - rick astley never gonna give you up lyrics
                    - rick astley interview
                    - rick astley cry for help
                    - rick astley songs
                    - rick astley never gonna give you up live
                    - rick astley take me to your heart
                    - rick astley she wants to dance with me
                    - rick astley it would take a strong strong man
                    - rick astley whenever you need somebody
                  total_count: 14
                requestId: aca97c0b-6216-4ba0-b502-df42fb0da1d7
          headers: {}
        '400':
          description: 请求参数错误，请检查必填字段和参数格式
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: 'Missing required parameter: handle'
        '401':
          description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: 账户余额或额度不足
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: 请求过于频繁，已触发限流
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: 服务器内部错误，请稍后重试
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 500
                  data: null
                  message: Internal server error
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/youtube/get_search_suggestions?keyword=Rick+Astley&language=en&region=US' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/youtube/get_search_suggestions',
                params={"keyword": "Rick Astley", "language": "en", "region": "US"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"keyword": "Rick Astley",
            "language": "en", "region": "US"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/youtube/get_search_suggestions?${params}`,
            {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````