@tikomni/skills 0.1.0

package/skills/creator-analysis/references/api-contracts/tiktok-shop-web-api.md

@@ -0,0 +1,1890 @@
+# TikTok-Shop-Web-API Full Contract
+
+- Back to index: [`api-capability-index.md`](../api-capability-index.md)
+- Back to route summary: [`api-tags/tiktok-shop-web-api.md`](../api-tags/tiktok-shop-web-api.md)
+- Current contract file: `api-contracts/tiktok-shop-web-api.md`
+- Source: `https://app.tikomni.com/openapi/tikomni-openapi.full.with-u2.public.latest.json`
+- Fetched at: `2026-03-08T06:54:04+00:00`
+- Route count: `15`
+- Default auth: Header `Authorization` Bearer
+- Read this file only when you need precise auth notes, parameter descriptions, defaults, examples, or success-response fields.
+- Tag description: **(TikTok电商网页版数据接口/TikTok-Shop-Web-API data endpoints)**
+
+## Route Contracts
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-hot-selling-products-list"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_hot_selling_products_list`
+
+- Summary: 获取热卖商品列表/Get hot selling products list
+- Capabilities: trends / rankings / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_hot_selling_products_list_api_v1_tiktok_shop_web_fetch_hot_selling_products_list_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取TikTok Shop的热卖商品列表
+> - 返回当前最受欢迎的商品
+> ### 参数:
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> - count: 返回商品数量，默认100 (可选)
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [                // 热卖商品列表(最多1000个)
+>             {
+>                 "product_id": "xxx",
+>                 "title": "商品标题",
+>                 "image": "商品图片",
+>                 "price": {},              // 价格信息
+>                 "rating": {},             // 评分信息
+>                 "sales": {},              // 销量信息
+>                 "rank": 1                 // 热卖排名
+>             }
+>         ]
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get TikTok Shop hot selling products list
+> - Returns currently most popular products
+> ### Parameters:
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> - count: Number of products to return, default 100 (optional)
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [                // Hot selling products (up to 1000)
+>             {
+>                 "product_id": "xxx",
+>                 "title": "Product title",
+>                 "image": "Product image",
+>                 "price": {},              // Price info
+>                 "rating": {},             // Rating info
+>                 "sales": {},              // Sales info
+>                 "rank": 1                 // Hot selling rank
+>             }
+>         ]
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+| count | query | integer | No | 返回商品数量/Number of products to return | 100 | 100 | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-product-detail"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_product_detail`
+
+- Summary: 获取商品详情V1(桌面端-数据完整)/Get product detail V1(Full data)
+- Capabilities: details / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_product_detail_api_v1_tiktok_shop_web_fetch_product_detail_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取TikTok Shop商品的详细信息
+> - 包含商品基本信息、价格、库存、评价、推荐商品等完整数据
+> - 某些特殊地区的商品可能无法获取到数据（如：泰国），如果遇到此情况请尝试使用 `fetch_product_detail_v3` 接口
+> ### 参数:
+> - seller_id: 卖家ID (可传空字符串)
+> - product_id: 商品ID (必填)
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "global_fe_config": {},      // 全局前端配置
+>         "components_map": [],         // 组件映射列表
+>         "global_data": {              // 全局数据
+>             "product_info": {},       // 商品信息
+>             "seller_info": {},        // 卖家信息
+>             "shipping_info": {},      // 物流信息
+>             "review_info": {}         // 评价信息
+>         }
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get detailed information of TikTok Shop products
+> - Contains complete data including basic info, price, stock, reviews, recommendations
+> - Some products from specific regions may not be accessible (e.g., Thailand); if so, try using `fetch_product_detail_v3`
+> ### Parameters:
+> - seller_id: Seller ID (can be empty string)
+> - product_id: Product ID (required)
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "global_fe_config": {},      // Global frontend config
+>         "components_map": [],         // Component mapping list
+>         "global_data": {              // Global data
+>             "product_info": {},       // Product information
+>             "seller_info": {},        // Seller information
+>             "shipping_info": {},      // Shipping information
+>             "review_info": {}         // Review information
+>         }
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> seller_id = "7494629757824764402"
+> product_id = "1729556436942358002"
+> region = "MY"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| product_id | query | string | Yes | 商品ID/Product ID | None | 1729556436942358002 | None |
+| seller_id | query | string | No | 卖家ID(可选)/Seller ID (optional) | None | 7494629757824764402 | None |
+| region | query | string | No | 地区代码/Region code | MY | MY | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-product-detail-v2"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_product_detail_v2`
+
+- Summary: 获取商品详情V2(移动端-数据少)/Get product detail V2 (Less Data)
+- Capabilities: details / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_product_detail_v2_api_v1_tiktok_shop_web_fetch_product_detail_v2_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取TikTok Shop商品详情(移动端接口)
+> - 数据结构更精简，响应速度更快
+> - 此接口返回的数据更少，如果需要更完整的数据请使用 `fetch_product_detail` 或 `fetch_product_detail_v3` 接口
+> ### 参数:
+> - seller_id: 卖家ID (可传空字符串)
+> - product_id: 商品ID (必填)
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "productDetailSchema": {},    // 商品详细信息
+>         "productCategoryInfoSchema": {}, // 分类信息
+>         "pdpRelatedKwSchema": [],     // 相关关键词
+>         "productsForComponentListSchema": [] // 推荐商品组件
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get TikTok Shop product details (Mobile API)
+> - More streamlined data structure with faster response
+> - This API returns less data; for more complete data, use `fetch_product_detail` or `fetch_product_detail_v3`
+> ### Parameters:
+> - seller_id: Seller ID (can be empty string)
+> - product_id: Product ID (required)
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "productDetailSchema": {},    // Product details
+>         "productCategoryInfoSchema": {}, // Category info
+>         "pdpRelatedKwSchema": [],     // Related keywords
+>         "productsForComponentListSchema": [] // Recommended product components
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> seller_id = "7494629757824764402"
+> product_id = "1729556436942358002"
+> region = "MY"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| product_id | query | string | Yes | 商品ID/Product ID | None | 1729556436942358002 | None |
+| seller_id | query | string | No | 卖家ID(可选)/Seller ID (optional) | None | 7494629757824764402 | None |
+| region | query | string | No | 地区代码/Region code | MY | MY | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-product-detail-v3"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_product_detail_v3`
+
+- Summary: 获取商品详情V3(移动端-数据完整)/Get product detail V3 (Full Data)
+- Capabilities: details / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_product_detail_v3_api_v1_tiktok_shop_web_fetch_product_detail_v3_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取TikTok Shop商品详情
+> - 提供最完整的商品信息，包括推荐商品、相关视频、店铺信息等
+> - 适用于所有地区的商品
+> ### 参数:
+> - product_id: 商品ID (必填)
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - **请务必确保 `product_id` 对应的 `region` 是正确的，否则接口将不会返回数据。**
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 200,
+>     "data": {
+>         "productInfo": {},                           // 商品详细信息
+>         "frequentlyBoughtTogether": [],              // 经常一起购买的商品
+>         "similarProductsInCategory": [],             // 同类别相似商品
+>         "exploreMoreFromShop": [],                   // 店铺更多商品
+>         "brandInCategoryRecommendedProducts": [],    // 品牌分类推荐商品
+>         "customersAlsoBought": [],                   // 顾客还购买了
+>         "moreInThisColorStyle": [],                  // 更多颜色款式
+>         "relatedVideos": [],                         // 相关视频
+>         "shopPerformance": {},                       // 店铺表现
+>         "categoryInfo": {},                          // 分类信息
+>         "searchRecommendWords": [],                  // 搜索推荐词
+>         "randomSearchWord": "",                      // 随机搜索词
+>         "shopInfo": {},                              // 店铺信息
+>         "shopHotReviews": []                         // 店铺热门评论
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get TikTok Shop product details
+> - Provides the most complete product information including recommendations, videos, shop info, etc.
+> - Suitable for products from all regions
+> ### Parameters:
+> - product_id: Product ID (required)
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - **Please ensure that the `region` matches the actual region of the `product_id`, otherwise the API will not return any data.**
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 200,
+>     "data": {
+>         "productInfo": {},                           // Product details
+>         "frequentlyBoughtTogether": [],              // Frequently bought together
+>         "similarProductsInCategory": [],             // Similar products in category
+>         "exploreMoreFromShop": [],                   // More from shop
+>         "brandInCategoryRecommendedProducts": [],    // Brand category recommendations
+>         "customersAlsoBought": [],                   // Customers also bought
+>         "moreInThisColorStyle": [],                  // More colors/styles
+>         "relatedVideos": [],                         // Related videos
+>         "shopPerformance": {},                       // Shop performance
+>         "categoryInfo": {},                          // Category info
+>         "searchRecommendWords": [],                  // Search recommendation words
+>         "randomSearchWord": "",                      // Random search word
+>         "shopInfo": {},                              // Shop information
+>         "shopHotReviews": []                         // Shop hot reviews
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> product_id = "1732108663255959373"
+> region = "SG"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| product_id | query | string | Yes | 商品ID/Product ID | None | 1732108663255959373 | None |
+| region | query | string | No | 地区代码/Region code | SG | SG | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-product-reviews-v1"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_product_reviews_v1`
+
+- Summary: 获取商品评论V1/Get product reviews V1
+- Capabilities: commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_product_reviews_v1_api_v1_tiktok_shop_web_fetch_product_reviews_v1_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取TikTok Shop商品的评论列表（支持所有国家区域的商品，无需指定地区代码）
+> - 支持按相关性或时间排序
+> - 支持评论筛选和分页加载
+> ### 参数:
+> - product_id: 商品ID (必填)
+> - sort_type: 排序方式
+>     - 1: 按相关性排序
+>     - 2: 按时间排序(最新)，默认值
+> - filter_id: 评论筛选ID (可选)
+>     - 可从首次响应的 review_filters 列表中获取
+> - offset: 分页偏移量，默认1
+>     - 如果响应中 has_more=1，使用 next_cursor 值进行下一页请求
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 200,
+>     "data": {
+>         "reviews": [                      // 评论列表(每页20条)
+>             {
+>                 "review_id": "xxx",
+>                 "user_info": {},          // 用户信息
+>                 "rating": 5,              // 评分(1-5星)
+>                 "review_content": "...",  // 评论内容
+>                 "images": [],             // 评论图片
+>                 "videos": [],             // 评论视频
+>                 "create_time": 0,         // 创建时间戳
+>                 "is_verified_buyer": true // 是否认证买家
+>             }
+>         ],
+>         "has_more": 1,                    // 是否有更多: 1=有, 0=无
+>         "next_cursor": "xxx",             // 下一页游标
+>         "review_filters": [               // 可用的筛选器
+>             {
+>                 "filter_id": "xxx",
+>                 "filter_name": "所有评论"
+>             }
+>         ],
+>         "statistics": {                   // 统计信息
+>             "total_count": 1000,
+>             "average_rating": 4.5,
+>             "rating_distribution": {}     // 星级分布
+>         }
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get TikTok Shop product reviews list (supports products from all countries/regions without specifying region code)
+> - Support sorting by relevance or time
+> - Support review filtering and pagination
+> ### Parameters:
+> - product_id: Product ID (required)
+> - sort_type: Sort type
+>     - 1: Sort by relevance
+>     - 2: Sort by recent (default)
+> - filter_id: Review filter ID (optional)
+>     - Can be obtained from review_filters list in first response
+> - offset: Offset for pagination, default 1
+>     - If has_more=1 in response, use next_cursor value for next page
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 200,
+>     "data": {
+>         "reviews": [                      // Review list (20 per page)
+>             {
+>                 "review_id": "xxx",
+>                 "user_info": {},          // User info
+>                 "rating": 5,              // Rating (1-5 stars)
+>                 "review_content": "...",  // Review content
+>                 "images": [],             // Review images
+>                 "videos": [],             // Review videos
+>                 "create_time": 0,         // Create timestamp
+>                 "is_verified_buyer": true // Is verified buyer
+>             }
+>         ],
+>         "has_more": 1,                    // Has more: 1=yes, 0=no
+>         "next_cursor": "xxx",             // Next page cursor
+>         "review_filters": [               // Available filters
+>             {
+>                 "filter_id": "xxx",
+>                 "filter_name": "All reviews"
+>             }
+>         ],
+>         "statistics": {                   // Statistics
+>             "total_count": 1000,
+>             "average_rating": 4.5,
+>             "rating_distribution": {}     // Rating distribution
+>         }
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> product_id = "1731677627342753961"
+> sort_type = 2
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| product_id | query | string | Yes | 商品ID/Product ID | None | 1731677627342753961 | None |
+| sort_type | query | integer | No | 排序方式/Sort type: 1=相关性/Relevance, 2=最新/Recent | 2 | 2 | None |
+| filter_id | query | string | No | 筛选ID/Filter ID | None | None | None |
+| offset | query | integer | No | 分页偏移量/Offset for pagination | 1 | 1 | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-product-reviews-v2"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_product_reviews_v2`
+
+- Summary: 获取商品评论V2/Get product reviews V2
+- Capabilities: commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_product_reviews_v2_api_v1_tiktok_shop_web_fetch_product_reviews_v2_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取TikTok Shop商品评论（仅支持美洲，欧洲，地区的商品，东南亚地区商品请使用 `fetch_product_reviews_v1` 接口）
+> - 支持多种筛选和排序方式
+> - 数据结构更完整，包含更多评论详情
+> ### 参数:
+> - product_id: 商品ID (必填)
+> - page_start: 起始页码，默认1
+>     - 当响应中 has_more=1 时，使用当前页码 +1 进行下一页请求
+> - sort_rule: 排序规则，默认2
+> - filter_type: 筛选类型
+>     - 1: 默认不选择任何过滤
+>     - 2: 包含图片或视频
+>     - 3: 真实购买过滤
+> - filter_value: 星级筛选
+>     - 6: 所有星级的评论(默认)
+>     - 5: 5星评价
+>     - 4: 4星评价
+>     - 3: 3星评价
+>     - 2: 2星评价
+>     - 1: 1星评价
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "reviews": [                      // 评论列表(每页20条)
+>             {
+>                 "review_id": "xxx",
+>                 "user": {                 // 用户信息
+>                     "user_id": "xxx",
+>                     "nickname": "用户昵称",
+>                     "avatar": "头像URL"
+>                 },
+>                 "rating": 5,              // 评分(1-5星)
+>                 "content": "评论内容",
+>                 "medias": [               // 媒体文件(图片/视频)
+>                     {
+>                         "type": "image",
+>                         "url": "媒体URL"
+>                     }
+>                 ],
+>                 "create_time": 0,         // 创建时间戳
+>                 "verified_purchase": true, // 是否认证购买
+>                 "product_info": {},       // 商品信息
+>                 "likes_count": 10,        // 点赞数
+>                 "seller_reply": {}        // 卖家回复
+>             }
+>         ],
+>         "has_more": 1,                    // 是否有更多: 1=有, 0=无
+>         "page_start": 1,                  // 当前页码
+>         "total_count": 500,               // 总评论数
+>         "review_summary": {               // 评论摘要
+>             "average_rating": 4.8,
+>             "star_distribution": {        // 星级分布
+>                 "5": 400,
+>                 "4": 80,
+>                 "3": 15,
+>                 "2": 3,
+>                 "1": 2
+>             }
+>         }
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get TikTok Shop product reviews (only supports products from Americas, Europe; for Southeast Asia products, use `fetch_product_reviews_v1`)
+> - Support multiple filtering and sorting options
+> - More complete data structure with detailed review information
+> ### Parameters:
+> - product_id: Product ID (required)
+> - page_start: Starting page number, default 1
+>     - When has_more=1 in response, use current page +1 for next page
+> - sort_rule: Sort rule, default 2
+> - filter_type: Filter type
+>     - 1: Default, no filter
+>     - 2: Contains images or videos
+>     - 3: Verified purchase filter
+> - filter_value: Star filter
+>     - 6: All star ratings (default)
+>     - 5: 5-star reviews
+>     - 4: 4-star reviews
+>     - 3: 3-star reviews
+>     - 2: 2-star reviews
+>     - 1: 1-star reviews
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "reviews": [                      // Review list (20 per page)
+>             {
+>                 "review_id": "xxx",
+>                 "user": {                 // User info
+>                     "user_id": "xxx",
+>                     "nickname": "Username",
+>                     "avatar": "Avatar URL"
+>                 },
+>                 "rating": 5,              // Rating (1-5 stars)
+>                 "content": "Review content",
+>                 "medias": [               // Media files (images/videos)
+>                     {
+>                         "type": "image",
+>                         "url": "Media URL"
+>                     }
+>                 ],
+>                 "create_time": 0,         // Create timestamp
+>                 "verified_purchase": true, // Is verified purchase
+>                 "product_info": {},       // Product info
+>                 "likes_count": 10,        // Likes count
+>                 "seller_reply": {}        // Seller reply
+>             }
+>         ],
+>         "has_more": 1,                    // Has more: 1=yes, 0=no
+>         "page_start": 1,                  // Current page
+>         "total_count": 500,               // Total review count
+>         "review_summary": {               // Review summary
+>             "average_rating": 4.8,
+>             "star_distribution": {        // Star distribution
+>                 "5": 400,
+>                 "4": 80,
+>                 "3": 15,
+>                 "2": 3,
+>                 "1": 2
+>             }
+>         }
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> product_id = "1729556436942358002"
+> page_start = 1
+> sort_rule = 2
+> filter_type = 1
+> filter_value = 6
+> region = "MY"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| product_id | query | string | Yes | 商品ID/Product ID | None | 1729556436942358002 | None |
+| page_start | query | integer | No | 起始页码/Page start | 1 | 1 | None |
+| sort_rule | query | integer | No | 排序规则/Sort rule | 2 | 2 | None |
+| filter_type | query | integer | No | 筛选类型/Filter type: 1=默认, 2=有图片/视频, 3=真实购买 | 1 | 1 | None |
+| filter_value | query | integer | No | 星级筛选/Star filter: 6=全部, 5-1=对应星级 | 6 | 6 | None |
+| region | query | string | No | 地区代码/Region code | MY | MY | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-products-by-category-id"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_products_by_category_id`
+
+- Summary: 根据分类ID获取商品列表/Get products by category ID
+- Capabilities: commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_products_by_category_id_api_v1_tiktok_shop_web_fetch_products_by_category_id_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 根据商品分类ID获取该分类下的商品列表
+> - 可用于构建分类浏览功能
+> ### 参数:
+> - category_id: 分类ID (必填，从fetch_products_category_list接口获取)
+> - offset: 翻页偏移量 (默认0)
+>     - 每页默认20个商品，每次请求增加20，当响应中的 `hasMore` 为true时可继续请求下一页，否则已到最后一页。
+>     - 例如: 第1页offset=0，第2页offset=20，第3页offset=40，以此类推。
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [                // 商品列表(最多20个)
+>             {
+>                 "product_id": "xxx",
+>                 "title": "商品标题",
+>                 "image": "商品图片",
+>                 "price": {},              // 价格信息
+>                 "rating": {},             // 评分信息
+>                 "sales": {}               // 销量信息
+>             }
+>         ]
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get product list by category ID
+> - Can be used to build category browsing feature
+> ### Parameters:
+> - category_id: Category ID (required, from fetch_products_category_list API)
+> - offset: Offset for pagination (default 0)
+>     - Default 20 products per page, increase by 20 for each request. If `hasMore` in response is true, can request next page, otherwise reached last page.
+>     - Example: Page 1 offset=0, Page 2 offset=20, Page 3 offset=40, and so on.
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [                // Product list (up to 20)
+>             {
+>                 "product_id": "xxx",
+>                 "title": "Product title",
+>                 "image": "Product image",
+>                 "price": {},              // Price info
+>                 "rating": {},             // Rating info
+>                 "sales": {}               // Sales info
+>             }
+>         ]
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> category_id = 963976
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| category_id | query | integer | Yes | 分类ID/Category ID | None | 963976 | None |
+| offset | query | integer | No | 翻页偏移量/Offset for pagination | 0 | 0 | None |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-products-category-list"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_products_category_list`
+
+- Summary: 获取商品分类列表/Get product category list
+- Capabilities: commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_products_category_list_api_v1_tiktok_shop_web_fetch_products_category_list_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取TikTok Shop的商品分类目录
+> - 返回完整的分类树结构
+> ### 参数:
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 返回数据结构:
+> ```json
+> [
+>     {
+>         "self": {                     // 分类自身信息
+>             "category_id": "xxx",
+>             "category_level": 1,
+>             "is_leaf": false,
+>             "parent_category_id": "0",
+>             "category_name": "分类名称",
+>             "category_name_en": "Category Name",
+>             "image_url": "分类图片URL"
+>         },
+>         "children": [                 // 子分类列表
+>             {
+>                 "self": {...},
+>                 "children": [...]
+>             }
+>         ]
+>     }
+> ]
+> ```
+> - 总共约28个主分类
+>
+> # [English]
+> ### Purpose:
+> - Get TikTok Shop product category directory
+> - Returns complete category tree structure
+> ### Parameters:
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Response Structure:
+> ```json
+> [
+>     {
+>         "self": {                     // Category info
+>             "category_id": "xxx",
+>             "category_level": 1,
+>             "is_leaf": false,
+>             "parent_category_id": "0",
+>             "category_name": "Category Name",
+>             "category_name_en": "Category Name",
+>             "image_url": "Category image URL"
+>         },
+>         "children": [                 // Sub-categories
+>             {
+>                 "self": {...},
+>                 "children": [...]
+>             }
+>         ]
+>     }
+> ]
+> ```
+> - Total about 28 main categories
+>
+> # [示例/Example]
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-search-products-list"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_search_products_list`
+
+- Summary: 搜索商品列表V1/Search products list V1
+- Capabilities: search / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_search_products_list_api_v1_tiktok_shop_web_fetch_search_products_list_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 根据关键词搜索商品
+> - 支持分页加载更多结果
+> ### 参数:
+> - search_word: 搜索关键词 (必填)
+> - offset: 偏移量，用于分页 (默认0)
+> - page_token: 分页标记，用于获取下一页
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [                // 商品列表(每页30个)
+>             {
+>                 "product_id": "xxx",
+>                 "title": "商品标题",
+>                 "image": "商品图片URL",
+>                 "product_price_info": {},  // 价格信息
+>                 "rate_info": {},           // 评分信息
+>                 "sold_info": {},           // 销量信息
+>                 "seller_info": {},         // 卖家信息
+>                 "seo_url": "商品SEO链接",
+>                 "product_marketing_info": {} // 营销信息
+>             }
+>         ],
+>         "has_more": true,             // 是否有更多
+>         "load_more_params": {         // 分页参数
+>             "offset": 30,
+>             "page_token": "xxx",
+>             "api_source": 2
+>         }
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Search products by keyword
+> - Support pagination to load more results
+> ### Parameters:
+> - search_word: Search keyword (required)
+> - offset: Offset for pagination (default 0)
+> - page_token: Page token for next page
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [                // Product list (30 per page)
+>             {
+>                 "product_id": "xxx",
+>                 "title": "Product title",
+>                 "image": "Product image URL",
+>                 "product_price_info": {},  // Price info
+>                 "rate_info": {},           // Rating info
+>                 "sold_info": {},           // Sales info
+>                 "seller_info": {},         // Seller info
+>                 "seo_url": "Product SEO URL",
+>                 "product_marketing_info": {} // Marketing info
+>             }
+>         ],
+>         "has_more": true,             // Has more
+>         "load_more_params": {         // Pagination params
+>             "offset": 30,
+>             "page_token": "xxx",
+>             "api_source": 2
+>         }
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> search_word = "labubu"
+> offset = 0
+> page_token = ""
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| search_word | query | string | Yes | 搜索关键词/Search keyword | None | labubu | None |
+| offset | query | integer | No | 偏移量/Offset | 0 | 0 | None |
+| page_token | query | string | No | 分页标记/Page token | None | None | None |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-search-products-list-v2"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_search_products_list_v2`
+
+- Summary: 搜索商品列表V2(移动端)/Search products list V2 (Mobile)
+- Capabilities: search / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_search_products_list_v2_api_v1_tiktok_shop_web_fetch_search_products_list_v2_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 搜索商品(移动端接口)
+> - 数据结构更精简，响应更快
+> ### 参数:
+> - search_word: 搜索关键词 (必填)
+> - offset: 偏移量 (默认0)
+> - page_token: 分页标记
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [...],            // 商品列表
+>         "has_more": true,             // 是否有更多
+>         "load_more_params": {}        // 加载更多参数
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Search products (Mobile API)
+> - More streamlined data, faster response
+> ### Parameters:
+> - search_word: Search keyword (required)
+> - offset: Offset (default 0)
+> - page_token: Page token
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [...],            // Product list
+>         "has_more": true,             // Has more
+>         "load_more_params": {}        // Load more params
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> search_word = "labubu"
+> offset = 0
+> page_token = ""
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| search_word | query | string | Yes | 搜索关键词/Search keyword | None | labubu | None |
+| offset | query | integer | No | 偏移量/Offset | 0 | 0 | None |
+| page_token | query | string | No | 分页标记/Page token | None | None | None |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-search-products-list-v3"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_search_products_list_v3`
+
+- Summary: 搜索商品列表V3/Search products list V3
+- Capabilities: search / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_search_products_list_v3_api_v1_tiktok_shop_web_fetch_search_products_list_v3_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 搜索TikTok Shop商品，支持高级筛选和排序
+> - 提供更多的筛选选项和排序方式
+> - 适合需要精细化筛选的场景
+> ### 参数:
+> - keyword: 搜索关键词 (必填)
+> - offset: 分页偏移量，默认0
+>     - 每页固定返回20个商品
+>     - 如果响应中 has_more=1，使用 cursor 值进行下一页请求
+> - region: 地区代码，Alpha-2 国家代码 (必填)
+> - sort_by: 排序方式，默认 RELEVANCE
+>     - RELEVANCE: 按相关性排序（默认）
+>     - PRICE_ASC: 价格从低到高
+>     - PRICE_DESC: 价格从高到低
+>     - BEST_SELLERS: 最畅销
+> - filters_data: 筛选数据，JSON数组格式字符串（可选）
+>     - 可从首次响应的 filter_groups 字段获取可用筛选器
+>     - 格式示例：
+>         - 简单筛选按钮: {"type": 2, "value": "true"}
+>         - 范围/多选: {"type": 8, "value_list": ["1,1000"]}
+>         - 完整示例（价格和4星及以上）: [{"type": 2, "value": "true"},{"type": 8, "value_list": ["1,1000"]}]
+> ### 重要提示:
+> - 每页固定返回20个商品
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 200,
+>     "data": {
+>         "products": [                  // 商品列表
+>             {
+>                 "product_id": "xxx",
+>                 "title": "商品标题",
+>                 "image": "商品图片URL",
+>                 "price": {             // 价格信息
+>                     "current_price": 19.99,
+>                     "original_price": 29.99,
+>                     "discount": "33% OFF"
+>                 },
+>                 "rating": {            // 评分信息
+>                     "average": 4.8,
+>                     "count": 1234
+>                 },
+>                 "sales": 5000,         // 销量
+>                 "seller_info": {},     // 卖家信息
+>                 "url": "商品链接"
+>             }
+>         ],
+>         "has_more": 1,                 // 是否有更多: 1=有, 0=无
+>         "cursor": "xxx",               // 下一页游标
+>         "filter_groups": [             // 可用的筛选器组
+>             {
+>                 "group_name": "价格",
+>                 "filters": [
+>                     {
+>                         "type": 8,
+>                         "name": "价格区间",
+>                         "options": [...]
+>                     }
+>                 ]
+>             },
+>             {
+>                 "group_name": "评分",
+>                 "filters": [
+>                     {
+>                         "type": 2,
+>                         "name": "4星及以上",
+>                         "value": "true"
+>                     }
+>                 ]
+>             }
+>         ],
+>         "total_count": 10000           // 总商品数
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Search TikTok Shop products with advanced filtering and sorting
+> - Provides more filter options and sort methods
+> - Suitable for scenarios requiring fine-grained filtering
+> ### Parameters:
+> - keyword: Search keyword (required)
+> - offset: Offset for pagination, default 0
+>     - Fixed 20 products per page
+>     - If has_more=1 in response, use cursor value for next page
+> - region: Region code, Alpha-2 country code (required)
+> - sort_by: Sort method, default RELEVANCE
+>     - RELEVANCE: Sort by relevance (default)
+>     - PRICE_ASC: Price low to high
+>     - PRICE_DESC: Price high to low
+>     - BEST_SELLERS: Best sellers
+> - filters_data: Filter data, JSON array format string (optional)
+>     - Available filters can be obtained from filter_groups field in first response
+>     - Format examples:
+>         - Simple filter button: {"type": 2, "value": "true"}
+>         - Range/multiple select: {"type": 8, "value_list": ["1,1000"]}
+>         - Complete example (price and 4+ stars): [{"type": 2, "value": "true"},{"type": 8, "value_list": ["1,1000"]}]
+> ### Important Notice:
+> - Fixed 20 products per page
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 200,
+>     "data": {
+>         "products": [                  // Product list
+>             {
+>                 "product_id": "xxx",
+>                 "title": "Product title",
+>                 "image": "Product image URL",
+>                 "price": {             // Price info
+>                     "current_price": 19.99,
+>                     "original_price": 29.99,
+>                     "discount": "33% OFF"
+>                 },
+>                 "rating": {            // Rating info
+>                     "average": 4.8,
+>                     "count": 1234
+>                 },
+>                 "sales": 5000,         // Sales count
+>                 "seller_info": {},     // Seller info
+>                 "url": "Product URL"
+>             }
+>         ],
+>         "has_more": 1,                 // Has more: 1=yes, 0=no
+>         "cursor": "xxx",               // Next page cursor
+>         "filter_groups": [             // Available filter groups
+>             {
+>                 "group_name": "Price",
+>                 "filters": [
+>                     {
+>                         "type": 8,
+>                         "name": "Price range",
+>                         "options": [...]
+>                     }
+>                 ]
+>             },
+>             {
+>                 "group_name": "Rating",
+>                 "filters": [
+>                     {
+>                         "type": 2,
+>                         "name": "4 Stars & Up",
+>                         "value": "true"
+>                     }
+>                 ]
+>             }
+>         ],
+>         "total_count": 10000           // Total product count
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> keyword = "baby"
+> offset = 0
+> region = "US"
+> sort_by = "PRICE_ASC"
+> filters_data = '[{"type": 2, "value": "true"},{"type": 8, "value_list": ["1,1000"]}]'
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| keyword | query | string | Yes | 搜索关键词/Search keyword | None | Labubu | None |
+| offset | query | integer | No | 偏移量/Offset | 0 | 0 | None |
+| region | query | string | No | 地区代码/Region code (Alpha-2) | US | US | None |
+| sort_by | query | string | No | 排序方式/Sort by: RELEVANCE, PRICE_ASC, PRICE_DESC, BEST_SELLERS | RELEVANCE | RELEVANCE | None |
+| filters_data | query | string | No | 筛选数据JSON/Filters data JSON | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-search-word-suggestion"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_search_word_suggestion`
+
+- Summary: 获取搜索关键词建议V1/Get search keyword suggestions V1
+- Capabilities: search / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_search_word_suggestion_api_v1_tiktok_shop_web_fetch_search_word_suggestion_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取搜索关键词的自动补全建议
+> - 用于搜索框的智能提示功能
+> ### 参数:
+> - search_word: 搜索关键词 (必填)
+> - lang: 语言代码 (en/zh等)
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "",
+>     "data": [                        // 建议列表(最多50个)
+>         "phone case",
+>         "phone mount",
+>         "phone holder for car",
+>         "..."
+>     ]
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get auto-complete suggestions for search keywords
+> - Used for search box smart suggestions
+> ### Parameters:
+> - search_word: Search keyword (required)
+> - lang: Language code (en/zh etc.)
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "",
+>     "data": [                        // Suggestion list (up to 50)
+>         "phone case",
+>         "phone mount",
+>         "phone holder for car",
+>         "..."
+>     ]
+> }
+> ```
+>
+> # [示例/Example]
+> search_word = "labubu"
+> lang = "en"
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| search_word | query | string | Yes | 搜索关键词/Search keyword | None | labubu | None |
+| lang | query | string | No | 语言/Language | en | en | None |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-search-word-suggestion-v2"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_search_word_suggestion_v2`
+
+- Summary: 获取搜索关键词建议V2(移动端)/Get search keyword suggestions V2 (Mobile)
+- Capabilities: search / commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_search_word_suggestion_v2_api_v1_tiktok_shop_web_fetch_search_word_suggestion_v2_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取搜索关键词建议(移动端接口)
+> - 专为电商搜索结果优化
+> ### 参数:
+> - search_word: 搜索关键词 (必填)
+> - lang: 语言代码 (en/zh等)
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "",
+>     "data": [                        // 建议列表(最多50个)
+>         "关键词1",
+>         "关键词2",
+>         "..."
+>     ]
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get search keyword suggestions (Mobile API)
+> - Optimized for e-commerce search results
+> ### Parameters:
+> - search_word: Search keyword (required)
+> - lang: Language code (en/zh etc.)
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "",
+>     "data": [                        // Suggestion list (up to 50)
+>         "keyword1",
+>         "keyword2",
+>         "..."
+>     ]
+> }
+> ```
+>
+> # [示例/Example]
+> search_word = "labubu"
+> lang = "en"
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| search_word | query | string | Yes | 搜索关键词/Search keyword | None | labubu | None |
+| lang | query | string | No | 语言/Language | en | en | None |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-seller-products-list"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_seller_products_list`
+
+- Summary: 获取商家商品列表V1/Get seller products list V1
+- Capabilities: commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_seller_products_list_api_v1_tiktok_shop_web_fetch_seller_products_list_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取指定商家的商品列表
+> - 支持分页加载更多商品
+> ### 参数:
+> - seller_id: 卖家ID (必填)
+> - search_params: 搜索参数，用于分页加载(可选)
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [                // 商品列表(每页30个)
+>             {
+>                 "product_id": "xxx",
+>                 "title": "商品标题",
+>                 "image": "商品图片URL",
+>                 "product_price_info": {},  // 价格信息
+>                 "rate_info": {},           // 评分信息
+>                 "sold_info": {},           // 销量信息
+>                 "seller_info": {},         // 卖家信息
+>                 "seo_url": "商品SEO链接"
+>             }
+>         ],
+>         "has_more": true,             // 是否有更多商品
+>         "load_more_params": {}        // 加载更多参数(用于下一页)
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get product list from specified seller
+> - Support pagination to load more products
+> ### Parameters:
+> - seller_id: Seller ID (required)
+> - search_params: Search parameters for pagination (optional)
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [                // Product list (30 per page)
+>             {
+>                 "product_id": "xxx",
+>                 "title": "Product title",
+>                 "image": "Product image URL",
+>                 "product_price_info": {},  // Price info
+>                 "rate_info": {},           // Rating info
+>                 "sold_info": {},           // Sales info
+>                 "seller_info": {},         // Seller info
+>                 "seo_url": "Product SEO URL"
+>             }
+>         ],
+>         "has_more": true,             // Has more products
+>         "load_more_params": {}        // Load more params (for next page)
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> seller_id = "7495150558072178725"
+> search_params = ""
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| seller_id | query | string | Yes | 卖家ID/Seller ID | None | 7495150558072178725 | None |
+| search_params | query | string | No | 搜索参数(用于分页)/Search params (for pagination) | None | 30_WzQzOSwzOTAwMDAwMCwxNzIzMDU4NTY3NTM5LCIxNzI5NTc3OTc3OTI0Nzg0MTY1Il0= | None |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-tiktok-shop-web-fetch-seller-products-list-v2"></a>
+### `GET /api/u1/v1/tiktok/shop/web/fetch_seller_products_list_v2`
+
+- Summary: 获取商家商品列表V2(移动端)/Get seller products list V2 (Mobile)
+- Capabilities: commerce
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `fetch_seller_products_list_v2_api_v1_tiktok_shop_web_fetch_seller_products_list_v2_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取商家商品列表(移动端接口)
+> - 数据结构更精简
+> ### 参数:
+> - seller_id: 卖家ID (必填)
+> - searchParams: 搜索参数(可选)
+> - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)
+> ### 重要提示:
+> - 由于接口风控原因，请务必将请求timeout设置为30秒
+> - 如遇到400错误代码，请重试请求3次
+> ### 返回数据结构:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [...],            // 商品列表
+>         "has_more": true,             // 是否有更多
+>         "load_more_params": {}        // 加载更多参数
+>     }
+> }
+> ```
+>
+> # [English]
+> ### Purpose:
+> - Get seller product list (Mobile API)
+> - More streamlined data structure
+> ### Parameters:
+> - seller_id: Seller ID (required)
+> - searchParams: Search parameters (optional)
+> - region: Region code (US/GB/SG/MY/PH/TH/VN/ID)
+> ### Important Notice:
+> - Due to API rate limiting, please set request timeout to 30 seconds
+> - If you encounter error code 400, please retry the request 3 times
+> ### Response Structure:
+> ```json
+> {
+>     "code": 0,
+>     "message": "success",
+>     "data": {
+>         "products": [...],            // Product list
+>         "has_more": true,             // Has more
+>         "load_more_params": {}        // Load more params
+>     }
+> }
+> ```
+>
+> # [示例/Example]
+> seller_id = "7495150558072178725"
+> searchParams = ""
+> region = "US"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| seller_id | query | string | Yes | 卖家ID/Seller ID | None | 7495150558072178725 | None |
+| searchParams | query | string | No | 搜索参数/Search params | None | None | None |
+| region | query | string | No | 地区代码/Region code | US | US | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |