{
  "openapi": "3.1.0",
  "info": {
    "title": "镜海数据公开 API",
    "version": "2026-09-21",
    "description": "提供 216 条产品接口的参考定义、请求参数与产品详情链接；项目凭证、计费与服务指标按对应接入方案执行。"
  },
  "servers": [
    {
      "url": "https://jhzyapi.com",
      "description": "公开 HTTPS 地址"
    }
  ],
  "tags": [
    {
      "name": "Shopee",
      "description": "20 个公开接口"
    },
    {
      "name": "TikTok / 抖音",
      "description": "27 个公开接口"
    },
    {
      "name": "Amazon",
      "description": "10 个公开接口"
    },
    {
      "name": "Cdiscount",
      "description": "8 个公开接口"
    },
    {
      "name": "Joybuy 京东国际",
      "description": "8 个公开接口"
    },
    {
      "name": "GrabFood",
      "description": "3 个公开接口"
    },
    {
      "name": "Lazada",
      "description": "19 个公开接口"
    },
    {
      "name": "Temu",
      "description": "19 个公开接口"
    },
    {
      "name": "eBay",
      "description": "7 个公开接口"
    },
    {
      "name": "AliExpress",
      "description": "4 个公开接口"
    },
    {
      "name": "YouTube",
      "description": "26 个公开接口"
    },
    {
      "name": "X / Twitter",
      "description": "21 个公开接口"
    },
    {
      "name": "Reddit",
      "description": "18 个公开接口"
    },
    {
      "name": "Google",
      "description": "3 个公开接口"
    },
    {
      "name": "Coupang",
      "description": "3 个公开接口"
    },
    {
      "name": "Rakuten 日本乐天",
      "description": "4 个公开接口"
    },
    {
      "name": "Naver 韩国门户",
      "description": "16 个公开接口"
    }
  ],
  "paths": {
    "/api/shopee/v1/product/detail": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "商品详情 V1",
        "description": "公开字段：found、status、名称、图片、价格、销量、库存状态、SKU、model ID",
        "operationId": "api_shopee_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-product-detail"
      }
    },
    "/api/shopee/v2/product/detail": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "商品详情 V2",
        "description": "公开字段：名称、图片、价格、销量、库存状态、SKU、model ID",
        "operationId": "api_shopee_v2_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v2-product-detail"
      }
    },
    "/api/shopee/v1/search/products": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "关键词商品搜索",
        "description": "公开字段：商品名、shop/item ID、display model ID、展示价、图片",
        "operationId": "api_shopee_v1_search_products",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-search-products"
      }
    },
    "/api/shopee/v1/shop/products": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "店铺商品卡片",
        "description": "公开字段：店铺首页商品卡、display model ID、展示价",
        "operationId": "api_shopee_v1_shop_products",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "username",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺账号",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-shop-products"
      }
    },
    "/api/shopee/v1/product/sku-matrix": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "商品规格矩阵",
        "description": "公开字段：规格维度、选项组合、review_count",
        "operationId": "api_shopee_v1_product_sku_matrix",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-product-sku-matrix"
      }
    },
    "/api/shopee/v1/shop/reviews-rich": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "店铺评论丰富版",
        "description": "公开字段：评论、媒体、标签、回复、点赞、翻译字段",
        "operationId": "api_shopee_v1_shop_reviews_rich",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-shop-reviews-rich"
      }
    },
    "/api/shopee/v1/product/snapshot": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "商品展示快照",
        "description": "公开字段：商品名、图片、规格、价格、评论标签",
        "operationId": "api_shopee_v1_product_snapshot",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-product-snapshot"
      }
    },
    "/api/shopee/v1/search/prefills": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "搜索推荐词",
        "description": "公开字段：运营预填词、推荐内容、跳转信息",
        "operationId": "api_shopee_v1_search_prefills",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-search-prefills"
      }
    },
    "/api/shopee/v1/search/filters": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "搜索筛选配置",
        "description": "公开字段：筛选组、筛选项、场景配置",
        "operationId": "api_shopee_v1_search_filters",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-search-filters"
      }
    },
    "/api/shopee/v1/shop/categories": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "店铺分类",
        "description": "公开字段：店内分类、分类层级、分类商品数",
        "operationId": "api_shopee_v1_shop_categories",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-shop-categories"
      }
    },
    "/api/shopee/v1/product/review-models": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "商品评论规格分布",
        "description": "公开字段：商品名、主图、规格维度、选项、组合评论数",
        "operationId": "api_shopee_v1_product_review_models",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-product-review-models"
      }
    },
    "/api/shopee/v1/product/installments": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "商品分期与金额",
        "description": "公开字段：分期方案、total_amount 商品金额",
        "operationId": "api_shopee_v1_product_installments",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "detailLevel",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-product-installments"
      }
    },
    "/api/shopee/v1/product/review-tags": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "商品评论标签",
        "description": "公开字段：评论标签、标签计数、洞察计数",
        "operationId": "api_shopee_v1_product_review_tags",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-product-review-tags"
      }
    },
    "/api/shopee/v1/product/reviews": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "指定商品评论",
        "description": "公开字段：评论正文、媒体、作者、评分、SKU 快照",
        "operationId": "api_shopee_v1_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "ratingType",
            "in": "query",
            "required": false,
            "description": "可选 · 0—5",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-product-reviews"
      }
    },
    "/api/shopee/v1/product/sku-models": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "SKU 型号观测",
        "description": "公开字段：model ID、model 名、快照 ID、观测次数",
        "operationId": "api_shopee_v1_product_sku_models",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "itemId",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "ratingType",
            "in": "query",
            "required": false,
            "description": "可选 · 0—5",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-product-sku-models"
      }
    },
    "/api/shopee/v1/search/facets": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "搜索类目分面",
        "description": "公开字段：类目、catid、结果数量、父子类目",
        "operationId": "api_shopee_v1_search_facets",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-search-facets"
      }
    },
    "/api/shopee/v1/shop/base": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "店铺基础资料",
        "description": "公开字段：shopid、店名、粉丝数、评分、账号资料",
        "operationId": "api_shopee_v1_shop_base",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "username",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺账号名",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-shop-base"
      }
    },
    "/api/shopee/v1/shop/detail": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "店铺详情",
        "description": "公开字段：店铺信息、账号资料、评分、装修与状态",
        "operationId": "api_shopee_v1_shop_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "username",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺账号名",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-shop-detail"
      }
    },
    "/api/shopee/v1/shop/reviews": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "店铺评论",
        "description": "公开字段：评论正文、作者、星级、媒体、product_items",
        "operationId": "api_shopee_v1_shop_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "ratingType",
            "in": "query",
            "required": false,
            "description": "可选 · 0—5",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-shop-reviews"
      }
    },
    "/api/shopee/v1/shop/seo": {
      "get": {
        "tags": [
          "Shopee"
        ],
        "summary": "店铺资料与评分摘要",
        "description": "公开字段：店铺标题、描述、评分摘要、关键词",
        "operationId": "api_shopee_v1_shop_seo",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 TW，支持 TW / ID / TH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/shopee/#endpoint-shopee-v1-shop-seo"
      }
    },
    "/api/tiktok/v1/shop/product/detail": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "TikTok Shop 商品详情",
        "description": "公开字段：商品信息、店铺信息、价格、SKU、类目、评价摘要",
        "operationId": "api_tiktok_v1_shop_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · TikTok Shop 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "in": "query",
            "required": false,
            "description": "可选 · 商品链接别名，默认 product",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include_split_data",
            "in": "query",
            "required": false,
            "description": "可选 · 是否包含延迟区块数据，默认 false",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-shop-product-detail"
      }
    },
    "/api/tiktok/v1/shop/search": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "TikTok Shop 商品搜索",
        "description": "公开字段：商品列表、店铺列表、筛选项、翻页游标、是否有下一页",
        "operationId": "api_tiktok_v1_shop_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 商品搜索关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 上一页返回的 JSON 游标，选填",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-shop-search"
      }
    },
    "/api/tiktok/v1/shop/product/reviews": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "TikTok Shop 商品评论",
        "description": "公开字段：评论列表、评分统计、图片视频、评论总数、是否有下一页",
        "operationId": "api_tiktok_v1_shop_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · TikTok Shop 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 页码，默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort_rule",
            "in": "query",
            "required": false,
            "description": "可选 · 排序：1 推荐，2 最新",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "filter_type",
            "in": "query",
            "required": false,
            "description": "可选 · 筛选：1 星级，2 带图视频，3 已验证购买",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "filter_value",
            "in": "query",
            "required": false,
            "description": "可选 · 1～5 星，6 表示全部",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-shop-product-reviews"
      }
    },
    "/api/tiktok/v1/video/detail": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "单视频解析",
        "description": "公开字段：视频 ID、标题、作者、播放地址、封面、互动指标",
        "operationId": "api_tiktok_v1_video_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "必填 · 视频完整链接",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hd",
            "in": "query",
            "required": false,
            "description": "可选 · 是否高清，默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-video-detail"
      }
    },
    "/api/tiktok/v1/douyin/feed": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "抖音推荐流",
        "description": "公开字段：推荐作品列表、互动指标、播放信息",
        "operationId": "api_tiktok_v1_douyin_feed",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-douyin-feed"
      }
    },
    "/api/tiktok/v1/ads/trends/hashtags": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门话题趋势",
        "description": "公开字段：话题名、排名、发布量、播放量、头部创作者",
        "operationId": "api_tiktok_v1_ads_trends_hashtags",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "country_code",
            "in": "query",
            "required": false,
            "description": "可选 · 国家码，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "description": "可选 · 统计周期 7 / 30 / 120，默认 7",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 页码，默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-trends-hashtags"
      }
    },
    "/api/tiktok/v1/douyin/hot": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "抖音热搜榜",
        "description": "公开字段：热搜词、热度、排名",
        "operationId": "api_tiktok_v1_douyin_hot",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-douyin-hot"
      }
    },
    "/api/tiktok/v1/ads/top/list": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告列表",
        "description": "公开字段：素材 ID、标题、行业、目标、点击率、封面",
        "operationId": "api_tiktok_v1_ads_top_list",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "country_code",
            "in": "query",
            "required": false,
            "description": "可选 · 国家码，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "description": "可选 · 统计周期 7 / 30 / 120，默认 30",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 页码，默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "required": false,
            "description": "可选 · 排序，默认 for_you",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-list"
      }
    },
    "/api/tiktok/v1/ads/trends/videos": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门视频趋势",
        "description": "公开字段：视频 ID、标题、封面、作者、互动指标",
        "operationId": "api_tiktok_v1_ads_trends_videos",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "country_code",
            "in": "query",
            "required": false,
            "description": "可选 · 国家码，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "description": "可选 · 统计周期 7 / 30 / 120，默认 30",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 页码，默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order_by_metric",
            "in": "query",
            "required": false,
            "description": "可选 · 排序指标 1～5，默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organic_only",
            "in": "query",
            "required": false,
            "description": "可选 · 是否只看自然流量，默认 false",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-trends-videos"
      }
    },
    "/api/tiktok/v1/ads/library/detail": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "广告库详情",
        "description": "公开字段：广告标题、广告主、落地页、定向、素材视频",
        "operationId": "api_tiktok_v1_ads_library_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 广告条目 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en-US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-library-detail"
      }
    },
    "/api/tiktok/v1/ads/library/regions": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "广告库支持地区",
        "description": "公开字段：地区代码、地区名称、覆盖说明",
        "operationId": "api_tiktok_v1_ads_library_regions",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en-US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-library-regions"
      }
    },
    "/api/tiktok/v1/ads/library/search": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "广告库搜索",
        "description": "公开字段：广告 ID、广告主、标题、展示日期、预估触达、封面",
        "operationId": "api_tiktok_v1_ads_library_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "region",
            "in": "query",
            "required": true,
            "description": "必填 · 两位国家码，如 DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 广告主或广告关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "required": false,
            "description": "可选 · 开始日期 YYYY-MM-DD，默认近 30 天",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "required": false,
            "description": "可选 · 结束日期 YYYY-MM-DD",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 页码，默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en-US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-library-search"
      }
    },
    "/api/tiktok/v1/ads/top/detail": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告详情",
        "description": "公开字段：标题、品牌、行业、点击率、落地页、视频",
        "operationId": "api_tiktok_v1_ads_top_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "material_id",
            "in": "query",
            "required": true,
            "description": "必填 · 热门广告素材 ID，取自列表接口",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-detail"
      }
    },
    "/api/tiktok/v1/ads/top/filters": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告筛选项",
        "description": "公开字段：语言、国家、行业、投放目标、样式、周期",
        "operationId": "api_tiktok_v1_ads_top_filters",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-filters"
      }
    },
    "/api/tiktok/v1/ads/top/keyframes": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告关键帧",
        "description": "公开字段：时长、高光点、逐秒分析点",
        "operationId": "api_tiktok_v1_ads_top_keyframes",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "material_id",
            "in": "query",
            "required": true,
            "description": "必填 · 热门广告素材 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-keyframes"
      }
    },
    "/api/tiktok/v1/ads/top/locations": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告地区字典",
        "description": "公开字段：国家码、国家名、默认市场",
        "operationId": "api_tiktok_v1_ads_top_locations",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-locations"
      }
    },
    "/api/tiktok/v1/ads/top/percentile": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告点击分位",
        "description": "公开字段：素材 ID、点击率分位",
        "operationId": "api_tiktok_v1_ads_top_percentile",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "material_id",
            "in": "query",
            "required": true,
            "description": "必填 · 热门广告素材 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "period_type",
            "in": "query",
            "required": false,
            "description": "可选 · 统计窗口 7 / 30 / 180，默认 180",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-percentile"
      }
    },
    "/api/tiktok/v1/ads/top/recommend": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告相似推荐",
        "description": "公开字段：相似广告列表、素材 ID、标题、封面",
        "operationId": "api_tiktok_v1_ads_top_recommend",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "material_id",
            "in": "query",
            "required": true,
            "description": "必填 · 热门广告素材 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "industry",
            "in": "query",
            "required": true,
            "description": "必填 · 行业 ID，取自列表 industry 字段",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country_code",
            "in": "query",
            "required": false,
            "description": "可选 · 国家码，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-recommend"
      }
    },
    "/api/tiktok/v1/ads/top/retention": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告留存曲线",
        "description": "公开字段：时长、留存曲线",
        "operationId": "api_tiktok_v1_ads_top_retention",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "material_id",
            "in": "query",
            "required": true,
            "description": "必填 · 热门广告素材 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-retention"
      }
    },
    "/api/tiktok/v1/ads/top/suggestions": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "热门广告搜索建议",
        "description": "公开字段：建议词列表",
        "operationId": "api_tiktok_v1_ads_top_suggestions",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-top-suggestions"
      }
    },
    "/api/tiktok/v1/ads/trends/countries": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "趋势国家字典",
        "description": "公开字段：国家码、国家名",
        "operationId": "api_tiktok_v1_ads_trends_countries",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-ads-trends-countries"
      }
    },
    "/api/tiktok/v1/challenge/detail": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "话题详情",
        "description": "公开字段：话题 ID、名称、播放量、视频数",
        "operationId": "api_tiktok_v1_challenge_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "challenge_name",
            "in": "query",
            "required": true,
            "description": "必填 · 话题名，不带 #，如 fyp",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-challenge-detail"
      }
    },
    "/api/tiktok/v1/shop/store/products": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "TikTok Shop 店铺商品",
        "description": "公开字段：店铺信息、商品列表、翻页游标、是否有下一页",
        "operationId": "api_tiktok_v1_shop_store_products",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "seller_id",
            "in": "query",
            "required": true,
            "description": "必填 · TikTok Shop 卖家 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "in": "query",
            "required": false,
            "description": "可选 · 店铺链接别名，默认 store",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 上一页返回的 JSON 游标，选填",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-shop-store-products"
      }
    },
    "/api/tiktok/v1/user/card": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "用户卡片",
        "description": "公开字段：作者名、标题摘要、缩略图、页面链接",
        "operationId": "api_tiktok_v1_user_card",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "unique_id",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名，不带 @",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-user-card"
      }
    },
    "/api/tiktok/v1/user/info": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "用户资料",
        "description": "公开字段：昵称、粉丝、获赞、作品数、头像、简介",
        "operationId": "api_tiktok_v1_user_info",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "unique_id",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名，不带 @，如 tiktok",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-user-info"
      }
    },
    "/api/tiktok/v1/user/videos": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "用户作品列表",
        "description": "公开字段：作品 ID、标题、播放/点赞/评论、封面、时长",
        "operationId": "api_tiktok_v1_user_videos",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "unique_id",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名，不带 @",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-user-videos"
      }
    },
    "/api/tiktok/v1/video/search": {
      "get": {
        "tags": [
          "TikTok / 抖音"
        ],
        "summary": "关键词搜视频",
        "description": "公开字段：作品列表、作者、互动指标",
        "operationId": "api_tiktok_v1_video_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keywords",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词，如 cat",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/tiktok/#endpoint-tiktok-v1-video-search"
      }
    },
    "/api/amazon/v1/product/reviews/count": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "筛选评论数量",
        "description": "公开字段：matching_review_count（准确数量）、is_exact（是否精确）、count_lower_bound（非精确时的数量下界）、count_text、filters、applied_filters_text、checked_at；返回精确数量或明确的数量下界。结果最多缓存 120 秒。",
        "operationId": "api_amazon_v1_product_reviews_count",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "asin",
            "in": "query",
            "required": true,
            "description": "必填 · 10 位商品 ASIN；筛选具体规格时传该规格 ASIN",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9]{10}$"
            },
            "example": "B0113UZJE2"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US；US / UK / DE / FR / IT / ES / JP / CA / MX / SE / NL / AE / TR / PL / SA / AU / BE / IN；GB 等同 UK，返回 site=UK；ASIN 须属于所选站点",
            "schema": {
              "type": "string",
              "enum": [
                "US",
                "UK",
                "DE",
                "FR",
                "IT",
                "ES",
                "JP",
                "CA",
                "MX",
                "SE",
                "NL",
                "AE",
                "TR",
                "PL",
                "SA",
                "AU",
                "BE",
                "IN",
                "GB"
              ],
              "default": "US"
            }
          },
          {
            "name": "filter_by_star",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 all_stars；one_star / two_star / three_star / four_star / five_star / positive / critical",
            "schema": {
              "type": "string",
              "enum": [
                "all_stars",
                "one_star",
                "two_star",
                "three_star",
                "four_star",
                "five_star",
                "positive",
                "critical"
              ],
              "default": "all_stars"
            }
          },
          {
            "name": "format_type",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 all_formats（全部规格）；current_format（仅传入 ASIN 的规格）",
            "schema": {
              "type": "string",
              "enum": [
                "all_formats",
                "current_format"
              ],
              "default": "all_formats"
            }
          },
          {
            "name": "reviewer_type",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 all_reviews；avp_only_reviews 表示仅已验证购买",
            "schema": {
              "type": "string",
              "enum": [
                "all_reviews",
                "avp_only_reviews"
              ],
              "default": "all_reviews"
            }
          },
          {
            "name": "media_type",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 all_contents；media_reviews_only 表示仅含图片或视频",
            "schema": {
              "type": "string",
              "enum": [
                "all_contents",
                "media_reviews_only"
              ],
              "default": "all_contents"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "可选 · 默认空；评论关键词，最多 200 字符",
            "schema": {
              "type": "string",
              "default": "",
              "maxLength": 200
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 recent；helpful 表示按有用程度排序，不改变筛选口径",
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "helpful"
              ],
              "default": "recent"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "success",
                        "error"
                      ]
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "asin": {
                          "type": "string"
                        },
                        "site": {
                          "type": "string"
                        },
                        "filters": {
                          "type": "object"
                        },
                        "matching_review_count": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 0
                        },
                        "count_lower_bound": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 0
                        },
                        "is_exact": {
                          "type": "boolean"
                        },
                        "count_text": {
                          "type": "string"
                        },
                        "applied_filters_text": {
                          "type": "string"
                        },
                        "checked_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-product-reviews-count"
      }
    },
    "/api/amazon/v1/product/detail": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "商品详情",
        "description": "公开字段：标题、品牌、评分、卖点、图片、价格、parent_asin、selected_variations、sku 变体矩阵",
        "operationId": "api_amazon_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "asin",
            "in": "query",
            "required": true,
            "description": "必填 · 10 位 ASIN",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-product-detail"
      }
    },
    "/api/amazon/v1/offer/listing": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "跟卖/报价列表",
        "description": "公开字段：报价条目、卖家、价格、配送信息",
        "operationId": "api_amazon_v1_offer_listing",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "asin",
            "in": "query",
            "required": true,
            "description": "必填 · 10 位 ASIN",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 all",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-offer-listing"
      }
    },
    "/api/amazon/v1/search/keyword": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "关键词搜索",
        "description": "公开字段：ASIN、标题、价格、评分、评论数、图片",
        "operationId": "api_amazon_v1_search_keyword",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-search-keyword"
      }
    },
    "/api/amazon/v1/offer/all": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "全部报价",
        "description": "公开字段：商品标题、全部报价数据",
        "operationId": "api_amazon_v1_offer_all",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "asin",
            "in": "query",
            "required": true,
            "description": "必填 · 10 位 ASIN",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-offer-all"
      }
    },
    "/api/amazon/v1/seller/storefront": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "卖家店铺页",
        "description": "公开字段：卖家名、地址块、店铺基础信息",
        "operationId": "api_amazon_v1_seller_storefront",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seller_id",
            "in": "query",
            "required": true,
            "description": "必填 · 卖家 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-seller-storefront"
      }
    },
    "/api/amazon/v1/bestsellers": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "畅销榜",
        "description": "公开字段：榜单 ASIN、排名、标题",
        "operationId": "api_amazon_v1_bestsellers",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "可选 · 类目 slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-bestsellers"
      }
    },
    "/api/amazon/v1/product/reviews": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "商品评论",
        "description": "公开字段：评论正文、星级、作者、时间、变体扩池",
        "operationId": "api_amazon_v1_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "asin",
            "in": "query",
            "required": true,
            "description": "必填 · 10 位 ASIN",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "required": false,
            "description": "可选 · recent/helpful",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter_by_star",
            "in": "query",
            "required": false,
            "description": "可选 · 空=全部，one_star..five_star/positive/critical",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand_variants",
            "in": "query",
            "required": false,
            "description": "可选 · true/false，默认 true",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-product-reviews"
      }
    },
    "/api/amazon/v1/search/suggestions": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "搜索联想",
        "description": "公开字段：联想词列表",
        "operationId": "api_amazon_v1_search_suggestions",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "prefix",
            "in": "query",
            "required": false,
            "description": "可选 · 输入前缀",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v1-search-suggestions"
      }
    },
    "/api/amazon/v2/product/detail": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "商品详情 v2",
        "description": "公开字段：标题、品牌、评分、卖点、图片、价格、规格",
        "operationId": "api_amazon_v2_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / UK / DE",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "asin",
            "in": "query",
            "required": true,
            "description": "必填 · 10 位 ASIN",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/amazon/#endpoint-amazon-v2-product-detail"
      }
    },
    "/api/cdiscount/v1/product/detail": {
      "get": {
        "tags": [
          "Cdiscount"
        ],
        "summary": "商品详情",
        "description": "公开字段：标题、品牌、EAN、类目、报价、图集、技术参数、能效与维修指数",
        "operationId": "api_cdiscount_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offer_id",
            "in": "query",
            "required": true,
            "description": "必填 · 报价 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/cdiscount/#endpoint-cdiscount-v1-product-detail"
      }
    },
    "/api/cdiscount/v1/product/offers": {
      "get": {
        "tags": [
          "Cdiscount"
        ],
        "summary": "商品报价列表",
        "description": "公开字段：报价 ID、卖家、欧元价格、参考价、配送地、评分与商品状态",
        "operationId": "api_cdiscount_v1_product_offers",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "department_id",
            "in": "query",
            "required": false,
            "description": "可选 · 部门 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category_node_id",
            "in": "query",
            "required": false,
            "description": "可选 · 类目节点",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 price",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort_direction",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 asc",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/cdiscount/#endpoint-cdiscount-v1-product-offers"
      }
    },
    "/api/cdiscount/v1/search/keyword": {
      "get": {
        "tags": [
          "Cdiscount"
        ],
        "summary": "关键词搜索",
        "description": "公开字段：商品 ID、报价 ID、标题、图片、欧元价格、评分、卖家",
        "operationId": "api_cdiscount_v1_search_keyword",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "department_id",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 10",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 relevance",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort_direction",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 desc",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/cdiscount/#endpoint-cdiscount-v1-search-keyword"
      }
    },
    "/api/cdiscount/v1/shop/products": {
      "get": {
        "tags": [
          "Cdiscount"
        ],
        "summary": "店铺商品",
        "description": "公开字段：商品 ID、报价 ID、标题、图片、价格、评分与销量",
        "operationId": "api_cdiscount_v1_shop_products",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "seller_id",
            "in": "query",
            "required": true,
            "description": "必填 · 卖家 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seller_name",
            "in": "query",
            "required": false,
            "description": "可选 · 店铺名",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "可选 · 店内关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 sales_7_days",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort_direction",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 desc",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/cdiscount/#endpoint-cdiscount-v1-shop-products"
      }
    },
    "/api/cdiscount/v1/shop/detail": {
      "get": {
        "tags": [
          "Cdiscount"
        ],
        "summary": "店铺详情",
        "description": "公开字段：店铺名称、累计销量、评分、评价数、评分分布与主体信息",
        "operationId": "api_cdiscount_v1_shop_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "seller_id",
            "in": "query",
            "required": true,
            "description": "必填 · 卖家 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/cdiscount/#endpoint-cdiscount-v1-shop-detail"
      }
    },
    "/api/cdiscount/v1/shop/reviews": {
      "get": {
        "tags": [
          "Cdiscount"
        ],
        "summary": "店铺评价",
        "description": "公开字段：平均分、评价总数、评分分布、作者、正文、星级与时间",
        "operationId": "api_cdiscount_v1_shop_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "seller_id",
            "in": "query",
            "required": true,
            "description": "必填 · 卖家 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "required": false,
            "description": "可选 · 排序方式",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "stars",
            "in": "query",
            "required": false,
            "description": "可选 · 1 至 5 星",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/cdiscount/#endpoint-cdiscount-v1-shop-reviews"
      }
    },
    "/api/cdiscount/v1/product/reviews": {
      "get": {
        "tags": [
          "Cdiscount"
        ],
        "summary": "商品评价",
        "description": "公开字段：商品评分、评价总数、评分分布、作者、标题、正文与时间",
        "operationId": "api_cdiscount_v1_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 2",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "stars",
            "in": "query",
            "required": false,
            "description": "可选 · 1 至 5 星",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/cdiscount/#endpoint-cdiscount-v1-product-reviews"
      }
    },
    "/api/cdiscount/v1/product/questions": {
      "get": {
        "tags": [
          "Cdiscount"
        ],
        "summary": "商品问答",
        "description": "公开字段：问题总数、已回答数、问题正文、作者、时间与答案列表",
        "operationId": "api_cdiscount_v1_product_questions",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "可选 · 问题关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 6",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "hydrate_answers",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 true",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/cdiscount/#endpoint-cdiscount-v1-product-questions"
      }
    },
    "/api/jdintl/v1/product/search": {
      "get": {
        "tags": [
          "Joybuy 京东国际"
        ],
        "summary": "商品搜索",
        "description": "公开字段：商品 ID、标题、主图、现价、原价、币种、有货状态",
        "operationId": "api_jdintl_v1_product_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 de, 支持 de/fr/uk",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/jdintl/#endpoint-jdintl-v1-product-search"
      }
    },
    "/api/jdintl/v2/product/search": {
      "get": {
        "tags": [
          "Joybuy 京东国际"
        ],
        "summary": "商品搜索V2",
        "description": "公开字段：商品 ID、标题、主图、现价、原价、品牌、折扣文案、销量文案、配送标签、有货状态",
        "operationId": "api_jdintl_v2_product_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 de, 支持 de/fr/uk",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/jdintl/#endpoint-jdintl-v2-product-search"
      }
    },
    "/api/jdintl/v1/product/detail": {
      "get": {
        "tags": [
          "Joybuy 京东国际"
        ],
        "summary": "商品详情",
        "description": "公开字段：标题、品牌、现价与原价、三级类目、主图集、SKU 变体(含图/库存)、促销满减、详情长图、店铺名、卖家 ID、评论摘要",
        "operationId": "api_jdintl_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 de",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/jdintl/#endpoint-jdintl-v1-product-detail"
      }
    },
    "/api/jdintl/v1/review/list": {
      "get": {
        "tags": [
          "Joybuy 京东国际"
        ],
        "summary": "商品评论",
        "description": "公开字段：评论总数、好评率、星级、评论正文、用户、时间、点赞、评论图片",
        "operationId": "api_jdintl_v1_review_list",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 de",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/jdintl/#endpoint-jdintl-v1-review-list"
      }
    },
    "/api/jdintl/v1/category/list": {
      "get": {
        "tags": [
          "Joybuy 京东国际"
        ],
        "summary": "类目树",
        "description": "公开字段：三级类目树(类目 ID、名称、层级)",
        "operationId": "api_jdintl_v1_category_list",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 de",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/jdintl/#endpoint-jdintl-v1-category-list"
      }
    },
    "/api/jdintl/v1/shop/search": {
      "get": {
        "tags": [
          "Joybuy 京东国际"
        ],
        "summary": "店铺搜索",
        "description": "公开字段：店铺 ID、店铺名、店铺 Logo、店铺类型",
        "operationId": "api_jdintl_v1_shop_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 品牌或关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 de",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/jdintl/#endpoint-jdintl-v1-shop-search"
      }
    },
    "/api/jdintl/v1/shop/detail": {
      "get": {
        "tags": [
          "Joybuy 京东国际"
        ],
        "summary": "店铺详情",
        "description": "公开字段：店铺 ID、店铺名、Logo、营业状态、卖家类型",
        "operationId": "api_jdintl_v1_shop_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "shop_id",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 de",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/jdintl/#endpoint-jdintl-v1-shop-detail"
      }
    },
    "/api/jdintl/v1/shop/products": {
      "get": {
        "tags": [
          "Joybuy 京东国际"
        ],
        "summary": "店铺商品",
        "description": "公开字段：该店铺全部在售商品卡片(商品 ID/标题/图/现价/原价/有货), 每页 20 条",
        "operationId": "api_jdintl_v1_shop_products",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "shop_id",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 de",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/jdintl/#endpoint-jdintl-v1-shop-products"
      }
    },
    "/api/grab/v1/restaurant/search": {
      "get": {
        "tags": [
          "GrabFood"
        ],
        "summary": "餐厅搜索",
        "description": "公开字段：商家 ID、店名、连锁品牌、菜系、评分、预计配送时长与配送费",
        "operationId": "api_grab_v1_restaurant_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "可选 · 搜索词, 空则按位置返回",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 MY, 支持 MY/SG/TH/PH/VN/ID/KH",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "可选 · 纬度, 默认国家中心",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": false,
            "description": "可选 · 经度, 默认国家中心",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/grab/#endpoint-grab-v1-restaurant-search"
      }
    },
    "/api/grab/v1/restaurant/menu": {
      "get": {
        "tags": [
          "GrabFood"
        ],
        "summary": "餐厅菜单",
        "description": "公开字段：店铺信息、分类、菜品、价格、折扣价、图片与规格组",
        "operationId": "api_grab_v1_restaurant_menu",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "merchant_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商家 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 MY",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "可选 · 纬度",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": false,
            "description": "可选 · 经度",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/grab/#endpoint-grab-v1-restaurant-menu"
      }
    },
    "/api/grab/v1/restaurant/recommend": {
      "get": {
        "tags": [
          "GrabFood"
        ],
        "summary": "餐厅推荐",
        "description": "公开字段：推荐商家分组与商家卡片",
        "operationId": "api_grab_v1_restaurant_recommend",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 MY",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "可选 · 纬度",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": false,
            "description": "可选 · 经度",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/grab/#endpoint-grab-v1-restaurant-recommend"
      }
    },
    "/api/lazada/v1/product/detail_live": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "商品详情（实时全量）",
        "description": "公开字段：商品模块、SKU 售价、原价、折扣与响应标志",
        "operationId": "api_lazada_v1_product_detail_live",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sku_id",
            "in": "query",
            "required": false,
            "description": "可选 · 提供后使用精确 SKU 路径",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-detail-live"
      }
    },
    "/api/lazada/v1/category/listing": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "类目商品列表",
        "description": "公开字段：类目商品卡、价格、图片、店铺",
        "operationId": "api_lazada_v1_category_listing",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "可选 · 类目 slug，如 mobiles",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-category-listing"
      }
    },
    "/api/lazada/v1/search/catalog": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "关键词搜索（Catalog）",
        "description": "公开字段：商品 ID、标题、价格、图片、店铺、评分、销量",
        "operationId": "api_lazada_v1_search_catalog",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-search-catalog"
      }
    },
    "/api/lazada/v1/search/keyword": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "关键词搜索",
        "description": "公开字段：商品 ID、标题、价格、图片、店铺、评分、销量",
        "operationId": "api_lazada_v1_search_keyword",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-search-keyword"
      }
    },
    "/api/lazada/v1/product/detail": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "商品详情",
        "description": "公开字段：标题、品牌、价格、SKU、图片、卖家、类目",
        "operationId": "api_lazada_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "必填 · 完整商品 URL",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-detail"
      }
    },
    "/api/lazada/v1/product/reviews": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "商品评论",
        "description": "公开字段：评论正文、评分、时间、买家",
        "operationId": "api_lazada_v1_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-reviews"
      }
    },
    "/api/lazada/v1/review/list": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "商品评论（增强）",
        "description": "公开字段：评论列表、印象标签、分页",
        "operationId": "api_lazada_v1_review_list",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-review-list"
      }
    },
    "/api/lazada/v1/product/delivery": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "商品配送选项",
        "description": "公开字段：地区、邮编、SKU 配送方式、时效与运费",
        "operationId": "api_lazada_v1_product_delivery",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seller_id",
            "in": "query",
            "required": false,
            "description": "可选 · 缺失时自动解析",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sku_id",
            "in": "query",
            "required": false,
            "description": "可选",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-delivery"
      }
    },
    "/api/lazada/v1/category/tree": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "完整类目树",
        "description": "公开字段：一级类目、子类目、多层导航、类目图片与链接",
        "operationId": "api_lazada_v1_category_tree",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-category-tree"
      }
    },
    "/api/lazada/v1/brand/listing": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "品牌商品列表",
        "description": "公开字段：商品卡、筛选条件、排序、分页、品牌与 SEO 元数据",
        "operationId": "api_lazada_v1_brand_listing",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "brand",
            "in": "query",
            "required": true,
            "description": "必填 · 品牌/标签 slug，如 apple",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-brand-listing"
      }
    },
    "/api/lazada/v1/context/site": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "站点上下文",
        "description": "公开字段：站点、区域与本地化上下文",
        "operationId": "api_lazada_v1_context_site",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-context-site"
      }
    },
    "/api/lazada/v1/product/aux_detail": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "商品辅助详情",
        "description": "公开字段：全 SKU 配送、保修、分期、优惠券、闪购",
        "operationId": "api_lazada_v1_product_aux_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seller_id",
            "in": "query",
            "required": false,
            "description": "可选 · 缺失时自动解析",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sku_id",
            "in": "query",
            "required": false,
            "description": "可选",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-aux-detail"
      }
    },
    "/api/lazada/v1/product/recommendations": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "商品相关推荐",
        "description": "公开字段：同店/同类推荐、价格、评分、销量、卖家、推荐模块",
        "operationId": "api_lazada_v1_product_recommendations",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-recommendations"
      }
    },
    "/api/lazada/v1/product/sku_list_prices": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "逐 SKU 列表价",
        "description": "公开字段：SKU ID、PDP 列表价、币种、规格路径、完整度",
        "operationId": "api_lazada_v1_product_sku_list_prices",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_skus",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 50，最大 50",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-sku-list-prices"
      }
    },
    "/api/lazada/v1/product/sku_prices": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "全规格价格",
        "description": "公开字段：SKU ID、售价、原价、折扣、规格路径",
        "operationId": "api_lazada_v1_product_sku_prices",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-sku-prices"
      }
    },
    "/api/lazada/v1/product/vouchers": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "商品优惠券",
        "description": "公开字段：优惠券列表、门槛、面额、有效期、领取信息",
        "operationId": "api_lazada_v1_product_vouchers",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-product-vouchers"
      }
    },
    "/api/lazada/v1/recommend": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "相关推荐",
        "description": "公开字段：推荐商品/联想结果",
        "operationId": "api_lazada_v1_recommend",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "可选 · 推荐种子词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "app_id",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 9802",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-recommend"
      }
    },
    "/api/lazada/v1/search/enhanced": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "关键词搜索（增强）",
        "description": "公开字段：实时商品集合、店铺、价格、销量与翻页信息",
        "operationId": "api_lazada_v1_search_enhanced",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-search-enhanced"
      }
    },
    "/api/lazada/v1/store/listing": {
      "get": {
        "tags": [
          "Lazada"
        ],
        "summary": "店铺商品列表",
        "description": "公开字段：店铺商品、店铺信息、筛选、排序、分页",
        "operationId": "api_lazada_v1_store_listing",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · SG / MY / TH / VN / PH / ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "store_path",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺 slug，如 ugreen",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 All-Products",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/lazada/#endpoint-lazada-v1-store-listing"
      }
    },
    "/api/temu/v1/homepage/hub": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "首页模块",
        "description": "公开字段：首页 Hub 模块、信任模块等",
        "operationId": "api_temu_v1_homepage_hub",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / EU / DE / UK / CA / AU 等",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-homepage-hub"
      }
    },
    "/api/temu/v1/category/top-sales": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "类目热销",
        "description": "公开字段：热销商品、价格、销量、评分、类目",
        "operationId": "api_temu_v1_category_top_sales",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "opt_id",
            "in": "query",
            "required": false,
            "description": "可选 · 类目 ID，默认 7320",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-category-top-sales"
      }
    },
    "/api/temu/v1/homepage/goods": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "首页商品流",
        "description": "公开字段：商品 ID、标题、价格、销量提示、主图、链接",
        "operationId": "api_temu_v1_homepage_goods",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / EU / DE / UK / CA / AU 等",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-homepage-goods"
      }
    },
    "/api/temu/v1/mall/recommend": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "店铺推荐商品",
        "description": "公开字段：店铺推荐商品、价格、销量、评分、SKU 变体",
        "operationId": "api_temu_v1_mall_recommend",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "mall_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 店铺 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-mall-recommend"
      }
    },
    "/api/temu/v1/homepage/activity": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "首页活动",
        "description": "公开字段：活动氛围、闪购/顶栏等模块",
        "operationId": "api_temu_v1_homepage_activity",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / EU / DE / UK / CA / AU 等",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-homepage-activity"
      }
    },
    "/api/temu/v1/setting": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "区域设置",
        "description": "公开字段：区域、语言、货币等站点设置",
        "operationId": "api_temu_v1_setting",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / EU / DE / UK / CA / AU 等",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-setting"
      }
    },
    "/api/temu/v1/product/detail": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "完整商品详情",
        "description": "公开字段：标题、价格、SKU、库存、规格、促销、配送、店铺、评论摘要",
        "operationId": "api_temu_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "goods_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "in": "query",
            "required": false,
            "description": "可选 · 商品 slug，默认 item",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "product_url",
            "in": "query",
            "required": false,
            "description": "可选 · 完整 Temu 商品 URL",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include_skus",
            "in": "query",
            "required": false,
            "description": "可选 · 是否返回 SKU，默认 true",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-product-detail"
      }
    },
    "/api/temu/v1/categories": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "商品类目树",
        "description": "公开字段：多级类目 ID、名称、图片、子类目",
        "operationId": "api_temu_v1_categories",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-categories"
      }
    },
    "/api/temu/v1/home/footer": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "页脚类目",
        "description": "公开字段：页脚版权与类目链接",
        "operationId": "api_temu_v1_home_footer",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / EU / DE / UK / CA / AU 等",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-home-footer"
      }
    },
    "/api/temu/v1/mall/goods": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "店铺商品列表",
        "description": "公开字段：店铺商品、价格、销量、评分、类目、SKU 变体",
        "operationId": "api_temu_v1_mall_goods",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "mall_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 店铺 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page_number",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-mall-goods"
      }
    },
    "/api/temu/v1/mall/info": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "店铺主体信息",
        "description": "公开字段：店铺名称、主体、地址、国家或地区",
        "operationId": "api_temu_v1_mall_info",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "mall_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 店铺 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-mall-info"
      }
    },
    "/api/temu/v1/mall/reviews": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "店铺评论列表",
        "description": "公开字段：评论正文、评分、图片、商品、SKU、时间",
        "operationId": "api_temu_v1_mall_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "mall_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 店铺 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort_type",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-mall-reviews"
      }
    },
    "/api/temu/v1/pay_icons": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "支付图标",
        "description": "公开字段：支付/安全图标资源",
        "operationId": "api_temu_v1_pay_icons",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / EU / DE / UK / CA / AU 等",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-pay-icons"
      }
    },
    "/api/temu/v1/product/reviews": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "商品评论列表",
        "description": "公开字段：评论正文、评分、规格、图片、视频、时间、用户展示名",
        "operationId": "api_temu_v1_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "goods_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-product-reviews"
      }
    },
    "/api/temu/v1/product/reviews/info": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "商品评论摘要",
        "description": "公开字段：评分、评论总数、星级分布、标签、商品核心信息",
        "operationId": "api_temu_v1_product_reviews_info",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "goods_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-product-reviews-info"
      }
    },
    "/api/temu/v1/product/similar": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "相似商品推荐",
        "description": "公开字段：相似商品、价格、销量、评分、店铺、SKU 变体",
        "operationId": "api_temu_v1_product_similar",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "goods_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-product-similar"
      }
    },
    "/api/temu/v1/product/snapshot": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "商品核心快照",
        "description": "公开字段：标题、价格、原价、折扣、图片、评分、评论统计",
        "operationId": "api_temu_v1_product_snapshot",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "goods_id",
            "in": "query",
            "required": true,
            "description": "必填 · Temu 商品 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-product-snapshot"
      }
    },
    "/api/temu/v1/search": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "关键词商品搜索",
        "description": "公开字段：商品、价格、销量、评分、评论数、店铺、图片",
        "operationId": "api_temu_v1_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-search"
      }
    },
    "/api/temu/v1/server_time": {
      "get": {
        "tags": [
          "Temu"
        ],
        "summary": "服务器时间",
        "description": "公开字段：服务器时间戳",
        "operationId": "api_temu_v1_server_time",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · US / EU / DE / UK / CA / AU 等",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/temu/#endpoint-temu-v1-server-time"
      }
    },
    "/api/ebay/v1/item/detail": {
      "get": {
        "tags": [
          "eBay"
        ],
        "summary": "商品详情",
        "description": "公开字段：标题、价格、图片、描述、SKU / 规格",
        "operationId": "api_ebay_v1_item_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 站点，如 US / UK / DE / FR",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": true,
            "description": "必填 · eBay 商品 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/ebay/#endpoint-ebay-v1-item-detail"
      }
    },
    "/api/ebay/v1/search/keyword": {
      "get": {
        "tags": [
          "eBay"
        ],
        "summary": "关键词搜索",
        "description": "公开字段：item_id、标题、价格、商品链接",
        "operationId": "api_ebay_v1_search_keyword",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 站点，如 US / UK / DE / AU / CA / FR",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词，如 iphone 15",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 页码，默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/ebay/#endpoint-ebay-v1-search-keyword"
      }
    },
    "/api/ebay/v1/seller/feedback": {
      "get": {
        "tags": [
          "eBay"
        ],
        "summary": "卖家评价页",
        "description": "公开字段：评价页标题、好评率候选、评分候选",
        "operationId": "api_ebay_v1_seller_feedback",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 站点，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seller",
            "in": "query",
            "required": true,
            "description": "必填 · 卖家用户名",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/ebay/#endpoint-ebay-v1-seller-feedback"
      }
    },
    "/api/ebay/v1/seller/items": {
      "get": {
        "tags": [
          "eBay"
        ],
        "summary": "卖家在售",
        "description": "公开字段：item_id、标题、价格",
        "operationId": "api_ebay_v1_seller_items",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 站点，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seller",
            "in": "query",
            "required": true,
            "description": "必填 · 卖家用户名",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 页码，默认 1",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/ebay/#endpoint-ebay-v1-seller-items"
      }
    },
    "/api/ebay/v1/seller/profile": {
      "get": {
        "tags": [
          "eBay"
        ],
        "summary": "卖家主页",
        "description": "公开字段：卖家名、页面标题、简介摘要",
        "operationId": "api_ebay_v1_seller_profile",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 站点，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seller",
            "in": "query",
            "required": true,
            "description": "必填 · 卖家用户名",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/ebay/#endpoint-ebay-v1-seller-profile"
      }
    },
    "/api/ebay/v1/product/family": {
      "get": {
        "tags": [
          "eBay"
        ],
        "summary": "产品族页",
        "description": "公开字段：产品标题、关联 listing / item",
        "operationId": "api_ebay_v1_product_family",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 站点，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 产品族 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/ebay/#endpoint-ebay-v1-product-family"
      }
    },
    "/api/ebay/v1/search/suggest": {
      "get": {
        "tags": [
          "eBay"
        ],
        "summary": "搜索联想",
        "description": "公开字段：联想词列表",
        "operationId": "api_ebay_v1_search_suggest",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 站点，默认 US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "必填 · 前缀词，如 iphone",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/ebay/#endpoint-ebay-v1-search-suggest"
      }
    },
    "/api/aliexpress/v1/product/reviews": {
      "get": {
        "tags": [
          "AliExpress"
        ],
        "summary": "商品评论",
        "description": "公开字段：评论正文、评分、国家、规格、附图、追评、印象标签、星级统计",
        "operationId": "api_aliexpress_v1_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID，如 1005007429636284",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 GLO · 站点，GLO 全球站 / US 美国站",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1 · 页码，从 1 开始",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter_by",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 all · 筛选，all / image / additional / local",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 complex_default · 排序，默认 complex_default",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/aliexpress/#endpoint-aliexpress-v1-product-reviews"
      }
    },
    "/api/aliexpress/v1/home/deals": {
      "get": {
        "tags": [
          "AliExpress"
        ],
        "summary": "首页特价",
        "description": "公开字段：商品 ID、现价、折扣、销量文案、主图",
        "operationId": "api_aliexpress_v1_home_deals",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US · 站点，GLO 全球站 / US 美国站",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/aliexpress/#endpoint-aliexpress-v1-home-deals"
      }
    },
    "/api/aliexpress/v1/product/overview": {
      "get": {
        "tags": [
          "AliExpress"
        ],
        "summary": "商品概述",
        "description": "公开字段：商品标题、描述、图集说明",
        "operationId": "api_aliexpress_v1_product_overview",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID，如 1005007429636284",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US · 站点，GLO 全球站 / US 美国站",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/aliexpress/#endpoint-aliexpress-v1-product-overview"
      }
    },
    "/api/aliexpress/v1/product/related": {
      "get": {
        "tags": [
          "AliExpress"
        ],
        "summary": "关联商品",
        "description": "公开字段：关联商品 ID、标题、热搜词",
        "operationId": "api_aliexpress_v1_product_related",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID，如 1005007429636284",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 US · 站点，GLO 全球站 / US 美国站",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/aliexpress/#endpoint-aliexpress-v1-product-related"
      }
    },
    "/api/youtube/v1/channel/updates": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "频道动态",
        "description": "公开字段：最近上传视频、标题、发布时间、播放量",
        "operationId": "api_youtube_v1_channel_updates",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "channel_id",
            "in": "query",
            "required": true,
            "description": "必填 · 频道 ID（UCxxxx），与 playlist_id 二选一",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "playlist_id",
            "in": "query",
            "required": false,
            "description": "可选 · 播放列表 ID，与 channel_id 二选一",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-channel-updates"
      }
    },
    "/api/youtube/v1/comments": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "评论列表",
        "description": "公开字段：评论正文、作者、点赞、回复数、翻页游标",
        "operationId": "api_youtube_v1_comments",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · top 或 newest，默认 top",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，上一页返回",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-comments"
      }
    },
    "/api/youtube/v1/video/embed": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "视频展示卡片",
        "description": "公开字段：标题、作者、缩略图",
        "operationId": "api_youtube_v1_video_embed",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "必填 · 完整 watch / youtu.be 链接",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-video-embed"
      }
    },
    "/api/youtube/v1/captions": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "字幕轨列表",
        "description": "公开字段：语言、轨名称、是否自动字幕",
        "operationId": "api_youtube_v1_captions",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-captions"
      }
    },
    "/api/youtube/v1/channel": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "频道页签",
        "description": "公开字段：频道资料、视频列表、翻页游标",
        "operationId": "api_youtube_v1_channel",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "channel",
            "in": "query",
            "required": true,
            "description": "必填 · UCxxxx / @handle / 频道 URL",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tab",
            "in": "query",
            "required": false,
            "description": "可选 · videos/shorts/streams/playlists/community/about/home",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-channel"
      }
    },
    "/api/youtube/v1/channel/search": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "频道内搜索",
        "description": "公开字段：频道内匹配视频列表",
        "operationId": "api_youtube_v1_channel_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "channel",
            "in": "query",
            "required": true,
            "description": "必填 · UCxxxx / @handle / 频道 URL",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "必填 · 频道内关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-channel-search"
      }
    },
    "/api/youtube/v1/comments/replies": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "评论回复",
        "description": "公开字段：回复正文、作者、点赞",
        "operationId": "api_youtube_v1_comments_replies",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 评论项中的回复游标",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-comments-replies"
      }
    },
    "/api/youtube/v1/hashtag": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "话题标签",
        "description": "公开字段：话题下视频列表",
        "operationId": "api_youtube_v1_hashtag",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "tag",
            "in": "query",
            "required": true,
            "description": "必填 · 话题名，如 music 或 #music",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-hashtag"
      }
    },
    "/api/youtube/v1/home/feed": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "发现流",
        "description": "公开字段：推荐视频卡片、翻页游标",
        "operationId": "api_youtube_v1_home_feed",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-home-feed"
      }
    },
    "/api/youtube/v1/live/chat": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "直播聊天",
        "description": "公开字段：聊天消息、Super Chat、续传游标",
        "operationId": "api_youtube_v1_live_chat",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 直播或回放视频 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 续传游标",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "replay",
            "in": "query",
            "required": false,
            "description": "可选 · true 拉回放弹幕，默认 false",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-live-chat"
      }
    },
    "/api/youtube/v1/music/browse": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "Music 榜单",
        "description": "公开字段：榜单/首页/新歌条目",
        "operationId": "api_youtube_v1_music_browse",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "feed",
            "in": "query",
            "required": false,
            "description": "可选 · charts / home / new_releases，默认 charts",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-music-browse"
      }
    },
    "/api/youtube/v1/music/search": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "Music 搜索",
        "description": "公开字段：歌曲/专辑/艺人卡片",
        "operationId": "api_youtube_v1_music_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "必填 · 音乐搜索词",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-music-search"
      }
    },
    "/api/youtube/v1/music/suggest": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "Music 联想",
        "description": "公开字段：联想词列表",
        "operationId": "api_youtube_v1_music_suggest",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "必填 · 前缀词",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-music-suggest"
      }
    },
    "/api/youtube/v1/playlist": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "播放列表",
        "description": "公开字段：列表标题、条目、翻页游标",
        "operationId": "api_youtube_v1_playlist",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "playlist_id",
            "in": "query",
            "required": true,
            "description": "必填 · 播放列表 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-playlist"
      }
    },
    "/api/youtube/v1/resolve-url": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "URL/句柄解析",
        "description": "公开字段：browse_id、canonical_url、video_id",
        "operationId": "api_youtube_v1_resolve_url",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "必填 · 频道/话题/短链 URL 或 @handle 链接",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-resolve-url"
      }
    },
    "/api/youtube/v1/search": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "关键词搜索",
        "description": "公开字段：视频/频道/播放列表卡片、预估结果数、翻页游标",
        "operationId": "api_youtube_v1_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词，如 lo-fi hip hop",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "required": false,
            "description": "可选 · video/channel/playlist/live/short 等",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-search"
      }
    },
    "/api/youtube/v1/search/suggest": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "搜索联想",
        "description": "公开字段：联想词列表",
        "operationId": "api_youtube_v1_search_suggest",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "必填 · 前缀词，如 lo-fi",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-search-suggest"
      }
    },
    "/api/youtube/v1/shorts/item": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "单条 Shorts",
        "description": "公开字段：Shorts 元数据与互动面板",
        "operationId": "api_youtube_v1_shorts_item",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · Shorts 视频 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-shorts-item"
      }
    },
    "/api/youtube/v1/shorts/sequence": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "Shorts 推荐序列",
        "description": "公开字段：Shorts 推荐序列条目",
        "operationId": "api_youtube_v1_shorts_sequence",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-shorts-sequence"
      }
    },
    "/api/youtube/v1/thumbnails": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "封面直链",
        "description": "公开字段：maxres/sd/hq/mq/default/webp 直链",
        "operationId": "api_youtube_v1_thumbnails",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-thumbnails"
      }
    },
    "/api/youtube/v1/transcript": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "字幕全文",
        "description": "公开字段：全文、分段时间轴、语言",
        "operationId": "api_youtube_v1_transcript",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": true,
            "description": "必填 · 字幕语言，如 en / zh-Hans",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-transcript"
      }
    },
    "/api/youtube/v1/video": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "视频元数据",
        "description": "公开字段：标题、频道、时长、播放量、发布时间、封面、分类",
        "operationId": "api_youtube_v1_video",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID，如 dQw4w9WgXcQ",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-video"
      }
    },
    "/api/youtube/v1/video/engagement": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "互动指标",
        "description": "公开字段：播放量、点赞、评论数、频道订阅数",
        "operationId": "api_youtube_v1_video_engagement",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-video-engagement"
      }
    },
    "/api/youtube/v1/video/full": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "视频完整信息",
        "description": "公开字段：元数据、点赞、订阅数、简介、相关视频",
        "operationId": "api_youtube_v1_video_full",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-video-full"
      }
    },
    "/api/youtube/v1/video/updated-metadata": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "指标轮询",
        "description": "公开字段：播放量、点赞、是否直播",
        "operationId": "api_youtube_v1_video_updated_metadata",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-video-updated-metadata"
      }
    },
    "/api/youtube/v1/watch/next": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "相关推荐",
        "description": "公开字段：相关视频、互动摘要、评论游标",
        "operationId": "api_youtube_v1_watch_next",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "video_id",
            "in": "query",
            "required": true,
            "description": "必填 · 11 位视频 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "playlist_id",
            "in": "query",
            "required": false,
            "description": "可选 · 播放列表 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 US",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/youtube/#endpoint-youtube-v1-watch-next"
      }
    },
    "/api/twitter/v1/profile/timeline": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "用户发文 V2",
        "description": "公开字段：V2 发文流、翻页信息",
        "operationId": "api_twitter_v1_profile_timeline",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "handle",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "可选 · 时间过滤",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "with_replies",
            "in": "query",
            "required": false,
            "description": "可选 · 是否含回复",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "groupthreads",
            "in": "query",
            "required": false,
            "description": "可选 · 是否聚合线程",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "可选 · 语言",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-profile-timeline"
      }
    },
    "/api/twitter/v1/tweet/card": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "单条内容快照",
        "description": "公开字段：正文、作者、互动统计",
        "operationId": "api_twitter_v1_tweet_card",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "id",
            "in": "query",
            "required": true,
            "description": "必填 · 内容 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 en",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-tweet-card"
      }
    },
    "/api/twitter/v1/friendships/show": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "账号关系判定",
        "description": "公开字段：是否关注、是否回关",
        "operationId": "api_twitter_v1_friendships_show",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "source_screen_name",
            "in": "query",
            "required": true,
            "description": "必填 · 源用户名（与 source_id 二选一）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "target_screen_name",
            "in": "query",
            "required": true,
            "description": "必填 · 目标用户名（与 target_id 二选一）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source_id",
            "in": "query",
            "required": false,
            "description": "可选 · 源用户 ID（可选）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "target_id",
            "in": "query",
            "required": false,
            "description": "可选 · 目标用户 ID（可选）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-friendships-show"
      }
    },
    "/api/twitter/v1/geo/search": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "地点检索",
        "description": "公开字段：地点候选、地理标识",
        "operationId": "api_twitter_v1_geo_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "必填 · 地点关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "可选 · 纬度",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "long",
            "in": "query",
            "required": false,
            "description": "可选 · 经度",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-geo-search"
      }
    },
    "/api/twitter/v1/lists/memberships": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "用户所属列表",
        "description": "公开字段：所属列表集合",
        "operationId": "api_twitter_v1_lists_memberships",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "user_id",
            "in": "query",
            "required": false,
            "description": "可选 · 用户 ID（与 screen_name 二选一）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "screen_name",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名（可选）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-lists-memberships"
      }
    },
    "/api/twitter/v1/lists/show": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "列表详情",
        "description": "公开字段：列表名称、描述、成员规模",
        "operationId": "api_twitter_v1_lists_show",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "list_id",
            "in": "query",
            "required": true,
            "description": "必填 · 列表 ID（优先）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "in": "query",
            "required": false,
            "description": "可选 · 列表标识（可选）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "owner_screen_name",
            "in": "query",
            "required": false,
            "description": "可选 · 列表所有者（配合 slug）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-lists-show"
      }
    },
    "/api/twitter/v1/profile/basic": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "用户资料（增强）",
        "description": "公开字段：增强版用户摘要字段",
        "operationId": "api_twitter_v1_profile_basic",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "user",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-profile-basic"
      }
    },
    "/api/twitter/v1/profile/detail": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "用户档案 V2",
        "description": "公开字段：V2 用户档案结构",
        "operationId": "api_twitter_v1_profile_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "handle",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "about_account",
            "in": "query",
            "required": false,
            "description": "可选 · 扩展开关",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-profile-detail"
      }
    },
    "/api/twitter/v1/profile/timeline_lite": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "用户内容时间线",
        "description": "公开字段：用户时间线内容集合",
        "operationId": "api_twitter_v1_profile_timeline_lite",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "screen_name",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名，不带 @",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-profile-timeline-lite"
      }
    },
    "/api/twitter/v1/search/posts": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "关键词历史搜索",
        "description": "公开字段：帖子 ID、作者、正文、发布时间、互动数据、下一页游标",
        "operationId": "api_twitter_v1_search_posts",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start_time",
            "in": "query",
            "required": false,
            "description": "可选 · 开始时间，默认结束时间前 60 天；日期按 UTC 解释",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_time",
            "in": "query",
            "required": false,
            "description": "可选 · 结束时间，默认当前时间；不含终点",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 下一页游标；翻页复用返回的起止时间",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-search-posts"
      }
    },
    "/api/twitter/v1/trends/available": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "热搜地区目录",
        "description": "公开字段：可查询热搜的地区清单",
        "operationId": "api_twitter_v1_trends_available",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-trends-available"
      }
    },
    "/api/twitter/v1/trends/closest": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "附近热搜地区",
        "description": "公开字段：附近可查热搜地区",
        "operationId": "api_twitter_v1_trends_closest",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "lat",
            "in": "query",
            "required": true,
            "description": "必填 · 纬度",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "long",
            "in": "query",
            "required": true,
            "description": "必填 · 经度",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-trends-closest"
      }
    },
    "/api/twitter/v1/trends/list": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "热搜榜 V2",
        "description": "公开字段：热搜词列表与热度信息",
        "operationId": "api_twitter_v1_trends_list",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 trending",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-trends-list"
      }
    },
    "/api/twitter/v1/trends/place": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "地区热搜榜",
        "description": "公开字段：热搜词、热度指标",
        "operationId": "api_twitter_v1_trends_place",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "woeid",
            "in": "query",
            "required": false,
            "description": "可选 · 地区 ID，1=全球",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-trends-place"
      }
    },
    "/api/twitter/v1/tweet/basic": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "单条内容（增强）",
        "description": "公开字段：增强版内容详情",
        "operationId": "api_twitter_v1_tweet_basic",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "user",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "query",
            "required": true,
            "description": "必填 · 内容 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-tweet-basic"
      }
    },
    "/api/twitter/v1/tweet/by_rest_id": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "单条内容详情",
        "description": "公开字段：正文、作者、发布时间、互动指标",
        "operationId": "api_twitter_v1_tweet_by_rest_id",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "tweet_id",
            "in": "query",
            "required": true,
            "description": "必填 · 内容 ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-tweet-by-rest-id"
      }
    },
    "/api/twitter/v1/tweet/detail": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "单条内容 V2",
        "description": "公开字段：V2 内容详情结构",
        "operationId": "api_twitter_v1_tweet_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "id",
            "in": "query",
            "required": true,
            "description": "必填 · 内容 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "可选 · 语言",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "about_account",
            "in": "query",
            "required": false,
            "description": "可选 · 扩展开关",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-tweet-detail"
      }
    },
    "/api/twitter/v1/tweet/embed": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "内容展示卡片",
        "description": "公开字段：展示卡片 HTML、作者与摘要",
        "operationId": "api_twitter_v1_tweet_embed",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "必填 · 内容完整 URL",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-tweet-embed"
      }
    },
    "/api/twitter/v1/user/by_screen_name": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "用户资料",
        "description": "公开字段：用户 ID、昵称、简介、粉丝/关注数、认证状态、头像",
        "operationId": "api_twitter_v1_user_by_screen_name",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "screen_name",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名，不带 @",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-user-by-screen-name"
      }
    },
    "/api/twitter/v1/user/highlights": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "用户精选内容",
        "description": "公开字段：精选内容列表",
        "operationId": "api_twitter_v1_user_highlights",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "user_id",
            "in": "query",
            "required": true,
            "description": "必填 · 用户 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-user-highlights"
      }
    },
    "/api/twitter/v1/user/tweets": {
      "get": {
        "tags": [
          "X / Twitter"
        ],
        "summary": "用户发文列表",
        "description": "公开字段：发文列表、互动数据、翻页游标",
        "operationId": "api_twitter_v1_user_tweets",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "user_id",
            "in": "query",
            "required": true,
            "description": "必填 · 用户 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/twitter/#endpoint-twitter-v1-user-tweets"
      }
    },
    "/api/reddit/v1/community/listing": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "社区内容列表",
        "description": "公开字段：帖子标题、正文摘要、作者、评分、评论数、发帖时间、配图与媒体地址",
        "operationId": "api_reddit_v1_community_listing",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "community",
            "in": "query",
            "required": true,
            "description": "必填 · 社区名，如 magsafe（也可直接粘 r/magsafe）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 hot · 排序，如 hot / new / top",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "t",
            "in": "query",
            "required": false,
            "description": "可选 · 时间窗（top 排序时），如 day / week / month / year",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-community-listing"
      }
    },
    "/api/reddit/v1/community/search": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "社区内搜索",
        "description": "公开字段：匹配帖子列表、评分、评论数、作者、社区、配图",
        "operationId": "api_reddit_v1_community_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "community",
            "in": "query",
            "required": true,
            "description": "必填 · 社区名，如 magsafe（也可直接粘 r/magsafe）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 关键词，如 anker / magsafe powerbank",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 new · 排序，如 relevance / new / top / comments",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "t",
            "in": "query",
            "required": false,
            "description": "可选 · 时间窗（top 排序时），如 day / week / month / year",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-community-search"
      }
    },
    "/api/reddit/v1/link/mentions": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "外链提及监测",
        "description": "公开字段：提及该站点的帖子、社区、评分、评论数、时间",
        "operationId": "api_reddit_v1_link_mentions",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "website",
            "in": "query",
            "required": true,
            "description": "必填 · 站点域名，如 anker.com",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 new · 排序，如 hot / new / top",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "t",
            "in": "query",
            "required": false,
            "description": "可选 · 时间窗（top 排序时），如 day / week / month / year",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-link-mentions"
      }
    },
    "/api/reddit/v1/post/related": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "同源内容讨论",
        "description": "公开字段：同链接帖子列表、所在社区、评分、评论数",
        "operationId": "api_reddit_v1_post_related",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "post_id",
            "in": "query",
            "required": true,
            "description": "必填 · 内容 ID，如 1va0gvr（也可直接粘 t3_1va0gvr）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-post-related"
      }
    },
    "/api/reddit/v1/search/posts": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "全站内容搜索",
        "description": "公开字段：全站帖子列表、社区、评分、评论数、摘要、配图",
        "operationId": "api_reddit_v1_search_posts",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 关键词，如 anker / magsafe powerbank",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序，如 relevance / new / top / comments",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "t",
            "in": "query",
            "required": false,
            "description": "可选 · 时间窗（top 排序时），如 day / week / month / year",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-search-posts"
      }
    },
    "/api/reddit/v1/trending/posts": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "热门内容流",
        "description": "公开字段：热门帖子列表、社区、评分、评论数、摘要",
        "operationId": "api_reddit_v1_trending_posts",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "scope",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 popular · 范围，popular / all / best",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-trending-posts"
      }
    },
    "/api/reddit/v1/user/posts": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "用户发文列表",
        "description": "公开字段：用户历史发文、社区、评分、摘要、配图",
        "operationId": "api_reddit_v1_user_posts",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "username",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名，如 spez（也可直接粘 u/spez）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序，如 new / top / hot",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-user-posts"
      }
    },
    "/api/reddit/v1/community/comments": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "社区评论流",
        "description": "公开字段：评论正文、作者、评分、所属内容、时间",
        "operationId": "api_reddit_v1_community_comments",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "community",
            "in": "query",
            "required": true,
            "description": "必填 · 社区名，如 magsafe（也可直接粘 r/magsafe）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-community-comments"
      }
    },
    "/api/reddit/v1/history/comments": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "历史评论检索",
        "description": "公开字段：历史评论正文、社区、作者、评分、时间",
        "operationId": "api_reddit_v1_history_comments",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "community",
            "in": "query",
            "required": false,
            "description": "可选 · 社区或作者至少填一个",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "author",
            "in": "query",
            "required": false,
            "description": "可选 · 社区或作者至少填一个",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "可选 · 时间下界，如 2024-01-01 或 unix 秒",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "description": "可选 · 时间上界，如 2025-01-01 或 unix 秒",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序，new（默认）/ old",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-history-comments"
      }
    },
    "/api/reddit/v1/post/comments": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "内容评论翻页",
        "description": "公开字段：评论正文、作者、评分、层级、父评论、时间",
        "operationId": "api_reddit_v1_post_comments",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "post_id",
            "in": "query",
            "required": true,
            "description": "必填 · 内容 ID，如 1va0gvr（也可直接粘 t3_1va0gvr）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "community",
            "in": "query",
            "required": false,
            "description": "可选 · 社区名，如 magsafe（也可直接粘 r/magsafe）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 评论排序，如 top / new / confidence",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-post-comments"
      }
    },
    "/api/reddit/v1/post/detail": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "内容详情与评论",
        "description": "公开字段：帖子详情全文、评论列表、作者、评分、时间、配图",
        "operationId": "api_reddit_v1_post_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "post_id",
            "in": "query",
            "required": true,
            "description": "必填 · 内容 ID，如 1va0gvr（也可直接粘 t3_1va0gvr）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "community",
            "in": "query",
            "required": false,
            "description": "可选 · 社区名，如 magsafe（也可直接粘 r/magsafe）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 评论排序，如 top / new / confidence",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-post-detail"
      }
    },
    "/api/reddit/v1/search/users": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "用户发现",
        "description": "公开字段：用户名、karma、注册时间、简介、头像",
        "operationId": "api_reddit_v1_search_users",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 关键词，如 anker / magsafe powerbank",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-search-users"
      }
    },
    "/api/reddit/v1/user/about": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "用户资料",
        "description": "公开字段：用户名、注册时间、发文/评论 karma、简介、头像",
        "operationId": "api_reddit_v1_user_about",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "username",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名，如 spez（也可直接粘 u/spez）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-user-about"
      }
    },
    "/api/reddit/v1/user/comments": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "用户评论列表",
        "description": "公开字段：评论正文、所在社区、评分、时间",
        "operationId": "api_reddit_v1_user_comments",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "username",
            "in": "query",
            "required": true,
            "description": "必填 · 用户名，如 spez（也可直接粘 u/spez）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序，如 new / top / hot",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-user-comments"
      }
    },
    "/api/reddit/v1/community/about": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "社区资料",
        "description": "公开字段：社区名、标题、简介、订阅数、创建时间、社区图标",
        "operationId": "api_reddit_v1_community_about",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "community",
            "in": "query",
            "required": true,
            "description": "必填 · 社区名，如 magsafe（也可直接粘 r/magsafe）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-community-about"
      }
    },
    "/api/reddit/v1/community/discover": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "社区发现",
        "description": "公开字段：社区名、标题、简介、订阅数、活跃人数、社区图标",
        "operationId": "api_reddit_v1_community_discover",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 关键词，如 anker / magsafe powerbank",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "可选 · 翻页游标，原样回传上一次响应的 next_cursor",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-community-discover"
      }
    },
    "/api/reddit/v1/community/suggest": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "社区名联想",
        "description": "公开字段：社区名、标题、订阅数、社区图标",
        "operationId": "api_reddit_v1_community_suggest",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 关键词，如 anker / magsafe powerbank",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-community-suggest"
      }
    },
    "/api/reddit/v1/history/posts": {
      "get": {
        "tags": [
          "Reddit"
        ],
        "summary": "历史内容检索",
        "description": "公开字段：历史帖子列表、社区、作者、评分、时间",
        "operationId": "api_reddit_v1_history_posts",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "community",
            "in": "query",
            "required": false,
            "description": "可选 · 社区或作者至少填一个",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "author",
            "in": "query",
            "required": false,
            "description": "可选 · 社区或作者至少填一个",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "可选 · 关键词，如 anker / magsafe powerbank",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "可选 · 时间下界，如 2024-01-01 或 unix 秒",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "description": "可选 · 时间上界，如 2025-01-01 或 unix 秒",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 排序，new（默认）/ old",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/reddit/#endpoint-reddit-v1-history-posts"
      }
    },
    "/api/google/v1/maps/search": {
      "get": {
        "tags": [
          "Google"
        ],
        "summary": "地图商户搜索",
        "description": "公开字段：商户名称、评分、评论数、地址、经纬度、place_id、feature id、类目",
        "operationId": "api_google_v1_maps_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索词，如 coffee shops in San Francisco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 us",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "可选 · 视口纬度，默认 37.7749",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": false,
            "description": "可选 · 视口经度，默认 -122.4194",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "zoom_meters",
            "in": "query",
            "required": false,
            "description": "可选 · 视口半径米，默认 12000",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "可选 · 分页偏移，默认 0",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/google/#endpoint-google-v1-maps-search"
      }
    },
    "/api/google/v1/maps/place_id": {
      "get": {
        "tags": [
          "Google"
        ],
        "summary": "地点标识解析",
        "description": "公开字段：页面标题、feature id、place_id",
        "operationId": "api_google_v1_maps_place_id",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "必填 · 完整 Google Maps 地点分享链接",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gl",
            "in": "query",
            "required": false,
            "description": "可选 · 地区，默认 us",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/google/#endpoint-google-v1-maps-place-id"
      }
    },
    "/api/google/v1/search/suggest": {
      "get": {
        "tags": [
          "Google"
        ],
        "summary": "搜索联想",
        "description": "公开字段：联想词列表",
        "operationId": "api_google_v1_search_suggest",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "必填 · 前缀词，如 starbucks",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "hl",
            "in": "query",
            "required": false,
            "description": "可选 · 语言，默认 en",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/google/#endpoint-google-v1-search-suggest"
      }
    },
    "/api/coupang/v1/product/search": {
      "get": {
        "tags": [
          "Coupang"
        ],
        "summary": "商品搜索",
        "description": "公开字段：商品 ID、标题、主图、价格、币种、评分、评论数",
        "operationId": "api_coupang_v1_product_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词，如 갤럭시、아이폰、laptop",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/coupang/#endpoint-coupang-v1-product-search"
      }
    },
    "/api/coupang/v1/product/detail": {
      "get": {
        "tags": [
          "Coupang"
        ],
        "summary": "商品详情",
        "description": "公开字段：商品 ID、标题、价格、原价、折扣率、评分、评论数、图集、单位价、火箭配送",
        "operationId": "api_coupang_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID，如 1915590980（搜索结果返回）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_id",
            "in": "query",
            "required": false,
            "description": "可选 · 可选，商品子项 ID（搜索结果返回）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "vendor_item_id",
            "in": "query",
            "required": false,
            "description": "可选 · 可选，卖家商品 ID（搜索结果返回）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/coupang/#endpoint-coupang-v1-product-detail"
      }
    },
    "/api/coupang/v1/product/reviews": {
      "get": {
        "tags": [
          "Coupang"
        ],
        "summary": "商品评论",
        "description": "公开字段：评论 ID、评分、标题、正文、有用数、评论时间、评论人、规格、附图、评分分布、总数",
        "operationId": "api_coupang_v1_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID，如 1915590980（搜索结果返回）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1 · 页码，从 1 开始，默认 1",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 best · 评论排序，best 最有用 / latest 最新，默认 best",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/coupang/#endpoint-coupang-v1-product-reviews"
      }
    },
    "/api/rakuten/v1/product/search": {
      "get": {
        "tags": [
          "Rakuten 日本乐天"
        ],
        "summary": "商品搜索",
        "description": "公开字段：店铺代码、商品代码、标题、主图、价格（JPY）、评分、评论数",
        "operationId": "api_rakuten_v1_product_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词，如 iPhone、イヤホン、ラーメン",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/rakuten/#endpoint-rakuten-v1-product-search"
      }
    },
    "/api/rakuten/v1/product/detail": {
      "get": {
        "tags": [
          "Rakuten 日本乐天"
        ],
        "summary": "商品详情",
        "description": "公开字段：店铺代码、商品代码、标题、卖点、图集、价格区间、评分、评论数、类目、规格选项、SKU 变体",
        "operationId": "api_rakuten_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "shop_code",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺代码，如 rakutenmobile-store（搜索结果返回）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_code",
            "in": "query",
            "required": true,
            "description": "必填 · 商品代码，如 iphone-17（搜索结果返回）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/rakuten/#endpoint-rakuten-v1-product-detail"
      }
    },
    "/api/rakuten/v1/product/reviews": {
      "get": {
        "tags": [
          "Rakuten 日本乐天"
        ],
        "summary": "商品评论",
        "description": "公开字段：评分、评论时间、评论人、性别、年龄段、购买规格、评论正文、评论总数、平均分",
        "operationId": "api_rakuten_v1_product_reviews",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "shop_code",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺代码，如 rakutenmobile-store（搜索结果返回）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "item_code",
            "in": "query",
            "required": true,
            "description": "必填 · 商品代码，如 iphone-17（搜索结果返回）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/rakuten/#endpoint-rakuten-v1-product-reviews"
      }
    },
    "/api/rakuten/v1/ranking/products": {
      "get": {
        "tags": [
          "Rakuten 日本乐天"
        ],
        "summary": "商品排行榜",
        "description": "公开字段：排名、店铺代码、商品代码、标题、主图、价格（分类榜）",
        "operationId": "api_rakuten_v1_ranking_products",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "genre_id",
            "in": "query",
            "required": false,
            "description": "可选 · 可选，类目 ID，如 560278（手机类目榜）；不传返回总榜",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/rakuten/#endpoint-rakuten-v1-ranking-products"
      }
    },
    "/api/naver/v1/keyword/suggest": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "搜索联想词",
        "description": "公开字段：关键词、联想词列表",
        "operationId": "api_naver_v1_keyword_suggest",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词，如 아이폰",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-keyword-suggest"
      }
    },
    "/api/naver/v1/category/tree": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "购物类目树",
        "description": "公开字段：类目 ID、类目名称、子类目列表",
        "operationId": "api_naver_v1_category_tree",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 0 · 类目 ID，如 50000001（时尚配饰大类）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-category-tree"
      }
    },
    "/api/naver/v1/keyword/trends": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "购物关键词趋势榜",
        "description": "公开字段：排名、关键词、类目 ID、日期区间",
        "operationId": "api_naver_v1_keyword_trends",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 50000001 · 类目 ID，如 50000001（时尚配饰大类）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "required": false,
            "description": "可选 · 开始日期 YYYY-MM-DD；不传为近 7 天",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "required": false,
            "description": "可选 · 结束日期 YYYY-MM-DD；不传为今天",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "age",
            "in": "query",
            "required": false,
            "description": "可选 · 年龄段筛选；不传为全部",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gender",
            "in": "query",
            "required": false,
            "description": "可选 · 性别筛选；不传为全部",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "device",
            "in": "query",
            "required": false,
            "description": "可选 · 设备筛选（pc/mo）；不传为全部",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1 · page",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-keyword-trends"
      }
    },
    "/api/naver/v1/news/list": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "新闻列表",
        "description": "公开字段：报社 ID、文章 ID、标题、报社名称",
        "operationId": "api_naver_v1_news_list",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "section",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 105 · 新闻板块 ID（105=IT/科学）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": false,
            "description": "可选 · 日期 YYYYMMDD；不传为当天",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1 · page",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-news-list"
      }
    },
    "/api/naver/v1/news/detail": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "新闻详情",
        "description": "公开字段：标题、报社、发布时间、正文、配图",
        "operationId": "api_naver_v1_news_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "press_id",
            "in": "query",
            "required": true,
            "description": "必填 · 报社 ID，如 421（新闻列表返回）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "article_id",
            "in": "query",
            "required": true,
            "description": "必填 · 文章 ID，如 0009154957（新闻列表返回）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-news-detail"
      }
    },
    "/api/naver/v1/news/comments": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "新闻评论",
        "description": "公开字段：评论 ID、评论人、正文、时间、点赞数、点踩数、评论总数",
        "operationId": "api_naver_v1_news_comments",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "press_id",
            "in": "query",
            "required": true,
            "description": "必填 · 报社 ID，如 421（新闻列表返回）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "article_id",
            "in": "query",
            "required": true,
            "description": "必填 · 文章 ID，如 0009154957（新闻列表返回）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1 · page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 favorite · 评论排序：favorite（热度）/ new（最新）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-news-comments"
      }
    },
    "/api/naver/v1/news/ranking": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "新闻日排行",
        "description": "公开字段：排名、标题、报社、报社 ID、文章 ID、发布时间",
        "operationId": "api_naver_v1_news_ranking",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-news-ranking"
      }
    },
    "/api/naver/v1/blog/posts": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "博客文章列表",
        "description": "公开字段：文章编号、标题、发布日期、评论数",
        "operationId": "api_naver_v1_blog_posts",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "blog_id",
            "in": "query",
            "required": true,
            "description": "必填 · 博客 ID，如 naverofficial",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 1 · page",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-blog-posts"
      }
    },
    "/api/naver/v1/blog/post/detail": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "博客文章详情",
        "description": "公开字段：标题、发布时间、正文、图集",
        "operationId": "api_naver_v1_blog_post_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "blog_id",
            "in": "query",
            "required": true,
            "description": "必填 · 博客 ID，如 naverofficial",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "log_no",
            "in": "query",
            "required": true,
            "description": "必填 · 文章编号，如 224400531915（博客列表返回）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-blog-post-detail"
      }
    },
    "/api/naver/v1/webtoon/list": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "Webtoon 周榜",
        "description": "公开字段：作品 ID、标题、作者、评分、完结状态、封面",
        "operationId": "api_naver_v1_webtoon_list",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "week",
            "in": "query",
            "required": false,
            "description": "可选 · 星期（mon..sun）；不传为服务器当天",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-webtoon-list"
      }
    },
    "/api/naver/v1/finance/quote": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "金融实时报价",
        "description": "公开字段：名称、现价、涨跌额、涨跌幅、开高低、成交量、成交额、EPS、BPS、股息",
        "operationId": "api_naver_v1_finance_quote",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 KOSPI · 代码：KOSPI/KOSDAQ 指数或 6 位个股代码",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-finance-quote"
      }
    },
    "/api/naver/v1/finance/timeline": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "金融分时行情",
        "description": "公开字段：时间、价格",
        "operationId": "api_naver_v1_finance_timeline",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 KOSPI · 代码：KOSPI/KOSDAQ 指数或 6 位个股代码",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-finance-timeline"
      }
    },
    "/api/naver/v1/place/search": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "地点搜索",
        "description": "公开字段：地点 ID、名称、类目、道路地址、经纬度、评论数",
        "operationId": "api_naver_v1_place_search",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "必填 · 搜索关键词，如 아이폰",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 37.5665 · 纬度；不传为首尔市中心",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": false,
            "description": "可选 · 默认 126.9780 · 经度；不传为首尔市中心",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-place-search"
      }
    },
    "/api/naver/v1/place/detail": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "地点详情",
        "description": "公开字段：名称、类目、地址、营业时间、评分、评论数、博客评论数、图集",
        "operationId": "api_naver_v1_place_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "place_id",
            "in": "query",
            "required": true,
            "description": "必填 · 地点 ID，如 37749845（地点搜索返回）",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-place-detail"
      }
    },
    "/api/naver/v1/product/detail": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "SmartStore 商品详情",
        "description": "公开字段：商品 ID、标题、价格（KRW）、优惠价、品牌、制造商、类目链、店铺、评分、评论数、图集、运费、配送快递、相似商品",
        "operationId": "api_naver_v1_product_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "必填 · 商品 ID，如 12460786735",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-product-detail"
      }
    },
    "/api/naver/v1/shop/detail": {
      "get": {
        "tags": [
          "Naver 韩国门户"
        ],
        "summary": "SmartStore 店铺详情",
        "description": "公开字段：店铺标识、店铺名称、品牌店名、经营主体类型、简介、状态",
        "operationId": "api_naver_v1_shop_detail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "description": "项目调用凭证占位；真实值应保存在服务端。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_TOKEN"
          },
          {
            "name": "store",
            "in": "query",
            "required": true,
            "description": "必填 · 店铺标识，如 royalbabykorea",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "请求或凭证错误；具体结构以接口响应为准。"
          },
          "5XX": {
            "description": "服务侧错误；采用有上限重试并保留请求证据。"
          }
        },
        "x-product-page": "/products/naver/#endpoint-naver-v1-shop-detail"
      }
    }
  },
  "x-generated-at": "2026-09-21T16:47:09+08:00",
  "x-public-interface-count": 216
}