@tikomni/skills 0.1.2 → 0.1.4

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

@@ -1,663 +0,0 @@
-# TikTok-Shop-Web-API Route Summary
-
-- Back to index: [`api-capability-index.md`](../api-capability-index.md)
-- Current tag file: `api-tags/tiktok-shop-web-api.md`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md`](../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`
-- Common capabilities: commerce / search / details / trends / rankings
-- Default auth: Header `Authorization` Bearer
-- Common inputs: `region`, `product_id`, `offset`, `seller_id`, `search_word`, `page_token`, `lang`, `count`, `sort_type`, `filter_id`
-- Tag description: **(TikTok电商网页版数据接口/TikTok-Shop-Web-API data endpoints)**
-
-## Routes
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-hot-selling-products-list`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-hot-selling-products-list)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| region | query | string | No | 地区代码/Region code |
-| count | query | integer | No | 返回商品数量/Number of products to return |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-detail`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-detail)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| product_id | query | string | Yes | 商品ID/Product ID |
-| seller_id | query | string | No | 卖家ID(可选)/Seller ID (optional) |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-detail-v2`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-detail-v2)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| product_id | query | string | Yes | 商品ID/Product ID |
-| seller_id | query | string | No | 卖家ID(可选)/Seller ID (optional) |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-detail-v3`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-detail-v3)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| product_id | query | string | Yes | 商品ID/Product ID |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-reviews-v1`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-reviews-v1)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| product_id | query | string | Yes | 商品ID/Product ID |
-| sort_type | query | integer | No | 排序方式/Sort type: 1=相关性/Relevance, 2=最新/Recent |
-| filter_id | query | string | No | 筛选ID/Filter ID |
-| offset | query | integer | No | 分页偏移量/Offset for pagination |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-reviews-v2`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-product-reviews-v2)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| product_id | query | string | Yes | 商品ID/Product ID |
-| page_start | query | integer | No | 起始页码/Page start |
-| sort_rule | query | integer | No | 排序规则/Sort rule |
-| filter_type | query | integer | No | 筛选类型/Filter type: 1=默认, 2=有图片/视频, 3=真实购买 |
-| filter_value | query | integer | No | 星级筛选/Star filter: 6=全部, 5-1=对应星级 |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-products-by-category-id`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-products-by-category-id)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| category_id | query | integer | Yes | 分类ID/Category ID |
-| offset | query | integer | No | 翻页偏移量/Offset for pagination |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-products-category-list`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-products-category-list)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-products-list`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-products-list)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| search_word | query | string | Yes | 搜索关键词/Search keyword |
-| offset | query | integer | No | 偏移量/Offset |
-| page_token | query | string | No | 分页标记/Page token |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-products-list-v2`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-products-list-v2)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| search_word | query | string | Yes | 搜索关键词/Search keyword |
-| offset | query | integer | No | 偏移量/Offset |
-| page_token | query | string | No | 分页标记/Page token |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-products-list-v3`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-products-list-v3)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| keyword | query | string | Yes | 搜索关键词/Search keyword |
-| offset | query | integer | No | 偏移量/Offset |
-| region | query | string | No | 地区代码/Region code (Alpha-2) |
-| sort_by | query | string | No | 排序方式/Sort by: RELEVANCE, PRICE_ASC, PRICE_DESC, BEST_SELLERS |
-| filters_data | query | string | No | 筛选数据JSON/Filters data JSON |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-word-suggestion`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-word-suggestion)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| search_word | query | string | Yes | 搜索关键词/Search keyword |
-| lang | query | string | No | 语言/Language |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-word-suggestion-v2`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-search-word-suggestion-v2)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| search_word | query | string | Yes | 搜索关键词/Search keyword |
-| lang | query | string | No | 语言/Language |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-seller-products-list`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-seller-products-list)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| seller_id | query | string | Yes | 卖家ID/Seller ID |
-| search_params | query | string | No | 搜索参数(用于分页)/Search params (for pagination) |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.
-
-### `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`
-- Full contract: [`api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-seller-products-list-v2`](../api-contracts/tiktok-shop-web-api.md#get-api-u1-v1-tiktok-shop-web-fetch-seller-products-list-v2)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| seller_id | query | string | Yes | 卖家ID/Seller ID |
-| searchParams | query | string | No | 搜索参数/Search params |
-| region | query | string | No | 地区代码/Region code |
-
-#### 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 |
-| --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) |
-| support | string | No | Support message \| 支持消息 |
-| time | string | No | The time the response was generated \| 生成响应的时间 |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL |
-
-- Fields truncated: this layer shows only the first `12` rows.