@tikomni/skills 0.1.3 → 0.1.4

package/skills/meta-capability/references/api-tags/tiktok-ads-api.md

@@ -1,1393 +0,0 @@
-# TikTok-Ads-API Route Summary
-
-- Back to index: [`api-capability-index.md`](../api-capability-index.md)
-- Current tag file: `api-tags/tiktok-ads-api.md`
-- Full contract: [`api-contracts/tiktok-ads-api.md`](../api-contracts/tiktok-ads-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: `31`
-- Common capabilities: ads / search / details / creators / commerce / topics
-- Default auth: Header `Authorization` Bearer
-- Common inputs: `limit`, `page`, `country_code`, `period`, `keyword`, `period_type`, `industry`, `order_by`, `rank_type`, `material_id`
-- Tag description: **(TikTok广告创意中心数据接口/TikTok-Ads-Creative-Center-API endpoints)**
-
-## Routes
-
-### `GET /api/u1/v1/tiktok/ads/get_ad_interactive_analysis`
-
-- Summary: 获取广告互动分析/Get ad interactive analysis
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_ad_interactive_analysis_api_v1_tiktok_ads_get_ad_interactive_analysis_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-ad-interactive-analysis`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-ad-interactive-analysis)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| material_id | query | string | Yes | 广告素材ID/Ad material ID |
-| metric_type | query | string | No | 分析类型/Analysis type (ctr, cvr, clicks, conversion, remain) |
-| period_type | query | integer | No | 时间范围(天)/Period type (days) |
-
-#### 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/ads/get_ad_keyframe_analysis`
-
-- Summary: 获取广告关键帧分析/Get ad keyframe analysis
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_ad_keyframe_analysis_api_v1_tiktok_ads_get_ad_keyframe_analysis_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-ad-keyframe-analysis`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-ad-keyframe-analysis)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| material_id | query | string | Yes | 广告素材ID/Ad material ID |
-| metric | query | string | No | 分析指标/Analysis metric (retain_ctr, retain_cvr, click_cnt, convert_cnt, play_retain_cnt) |
-
-#### 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/ads/get_ad_percentile`
-
-- Summary: 获取广告百分位数据/Get ad percentile data
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_ad_percentile_api_v1_tiktok_ads_get_ad_percentile_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-ad-percentile`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-ad-percentile)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| material_id | query | string | Yes | 广告素材ID/Ad material ID |
-| metric | query | string | No | 分析指标/Analysis metric (ctr_percentile, time_attr_conversion_rate_percentile, click_cnt_percentile, time_attr_convert_cnt… |
-| period_type | query | integer | No | 时间范围(天)/Time period (days) |
-
-#### 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/ads/get_ads_detail`
-
-- Summary: 获取单个广告详情/Get single ad detail
-- Capabilities: details / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_ads_detail_api_v1_tiktok_ads_get_ads_detail_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-ads-detail`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-ads-detail)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| ads_id | query | string | Yes | 广告ID/Ad ID |
-
-#### 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/ads/get_creative_patterns`
-
-- Summary: 获取创意模式排行榜/Get creative pattern rankings
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_creative_patterns_api_v1_tiktok_ads_get_creative_patterns_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-creative-patterns`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-creative-patterns)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| first_industry_id | query | string | No | 一级行业ID/First industry ID |
-| period_type | query | string | No | 时间周期类型/Period type (week, month) |
-| order_field | query | string | No | 排序字段/Order field (ctr, play_over_rate) |
-| order_type | query | string | No | 排序方式/Sort order (desc, asc) |
-| week | query | string | No | 特定周（可选）/Specific week (optional) |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-
-#### 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/ads/get_creator_filters`
-
-- Summary: 获取创作者筛选器/Get creator filters
-- Capabilities: creators / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_creator_filters_api_v1_tiktok_ads_get_creator_filters_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-creator-filters`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-creator-filters)
-
-#### Parameters
-
-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 |
-| --- | --- | --- | --- |
-| 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/ads/get_creator_list`
-
-- Summary: 获取创作者列表/Get creator list
-- Capabilities: creators / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_creator_list_api_v1_tiktok_ads_get_creator_list_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-creator-list`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-creator-list)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| sort_by | query | string | No | 排序方式/Sort by (follower, engagement, avg_views) |
-| creator_country | query | string | No | 创作者国家/Creator country |
-| audience_country | query | string | No | 受众国家/Audience country |
-| audience_count | query | integer | No | 受众数量筛选/Audience count filter |
-| keyword | query | string | No | 关键词/Keyword |
-
-#### 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/ads/get_hashtag_creator`
-
-- Summary: 获取标签创作者信息/Get hashtag creator info
-- Capabilities: creators / ads / topics
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_hashtag_creator_api_v1_tiktok_ads_get_hashtag_creator_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-hashtag-creator`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-hashtag-creator)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| hashtag | query | string | Yes | 标签名称，不包含#符号/Hashtag name (without # symbol) |
-
-#### 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/ads/get_hashtag_filters`
-
-- Summary: 获取标签筛选器/Get hashtag filters
-- Capabilities: ads / topics
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_hashtag_filters_api_v1_tiktok_ads_get_hashtag_filters_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-hashtag-filters`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-hashtag-filters)
-
-#### Parameters
-
-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 |
-| --- | --- | --- | --- |
-| 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/ads/get_hashtag_list`
-
-- Summary: 获取热门标签列表/Get popular hashtags list
-- Capabilities: ads / topics
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_hashtag_list_api_v1_tiktok_ads_get_hashtag_list_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-hashtag-list`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-hashtag-list)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| period | query | integer | No | 时间范围（天）/Time period (days) |
-| country_code | query | string | No | 国家代码/Country code |
-| sort_by | query | string | No | 排序方式/Sort by (popular, new) |
-| industry_id | query | string | No | 行业ID/Industry ID |
-| filter_by | query | string | No | 筛选条件/Filter (new_on_board) |
-
-#### 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/ads/get_keyword_details`
-
-- Summary: 获取关键词详细信息/Get keyword details
-- Capabilities: details / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_keyword_details_api_v1_tiktok_ads_get_keyword_details_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-keyword-details`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-keyword-details)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| keyword | query | string | No | 关键词（可选）/Keyword (optional) |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| period | query | integer | No | 时间范围（天）/Time period (days) |
-| country_code | query | string | No | 国家代码/Country code |
-| order_by | query | string | No | 排序字段/Sort field |
-| order_type | query | string | No | 排序方式/Sort order (desc, asc) |
-| industry | query | string | No | 行业ID/Industry ID |
-| objective | query | string | No | 广告目标/Ad objective |
-| keyword_type | query | string | No | 关键词类型/Keyword type |
-
-#### 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/ads/get_keyword_filters`
-
-- Summary: 获取关键词筛选器/Get keyword filters
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_keyword_filters_api_v1_tiktok_ads_get_keyword_filters_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-keyword-filters`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-keyword-filters)
-
-#### Parameters
-
-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 |
-| --- | --- | --- | --- |
-| 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/ads/get_keyword_insights`
-
-- Summary: 获取关键词洞察数据/Get keyword insights data
-- Capabilities: ads / analytics
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_keyword_insights_api_v1_tiktok_ads_get_keyword_insights_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-keyword-insights`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-keyword-insights)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| period | query | integer | No | 时间段（天）/Time period (days, 7/30/120/180) |
-| country_code | query | string | No | 国家代码/Country code |
-| order_by | query | string | No | 排序字段/Sort field (post, ctr, click_rate, etc.) |
-| order_type | query | string | No | 排序方式/Sort order (desc, asc) |
-| industry | query | string | No | 行业ID/Industry ID |
-| objective | query | string | No | 广告目标/Ad objective |
-| keyword_type | query | string | No | 关键词类型/Keyword type |
-| keyword | query | string | No | 关键词/Keyword |
-
-#### 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/ads/get_keyword_list`
-
-- Summary: 获取关键词列表/Get keyword list
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_keyword_list_api_v1_tiktok_ads_get_keyword_list_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-keyword-list`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-keyword-list)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| keyword | query | string | No | 关键词/Keyword |
-| period | query | integer | No | 时间范围（天）/Time period (days) |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| country_code | query | string | No | 国家代码/Country code |
-| industry | query | string | No | 行业ID列表，逗号分隔/Industry IDs, comma separated |
-
-#### 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/ads/get_popular_trends`
-
-- Summary: 获取流行趋势视频/Get popular trend videos
-- Capabilities: trends / rankings / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_popular_trends_api_v1_tiktok_ads_get_popular_trends_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-popular-trends`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-popular-trends)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| period | query | integer | No | 时间范围（天）/Time period (days) |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| order_by | query | string | No | 排序字段/Order by (vv, like, comment, repost) |
-| country_code | query | string | No | 国家代码/Country 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/ads/get_product_detail`
-
-- Summary: 获取产品详细信息/Get product detail
-- Capabilities: details / commerce / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_product_detail_api_v1_tiktok_ads_get_product_detail_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-product-detail`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-product-detail)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| id | query | string | Yes | 产品类目ID/Product category ID |
-| last | query | integer | No | 最近天数/Last days |
-| ecom_type | query | string | No | 电商类型/E-commerce type |
-| period_type | query | string | No | 时间类型/Period type |
-| country_code | query | string | No | 国家代码/Country 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/ads/get_product_filters`
-
-- Summary: 获取产品筛选器/Get product filters
-- Capabilities: commerce / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_product_filters_api_v1_tiktok_ads_get_product_filters_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-product-filters`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-product-filters)
-
-#### Parameters
-
-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 |
-| --- | --- | --- | --- |
-| 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/ads/get_product_metrics`
-
-- Summary: 获取产品指标数据/Get product metrics
-- Capabilities: commerce / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_product_metrics_api_v1_tiktok_ads_get_product_metrics_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-product-metrics`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-product-metrics)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| id | query | string | Yes | 产品类目ID/Product category ID |
-| last | query | integer | No | 最近天数/Last days |
-| metrics | query | string | No | 指标类型，逗号分隔/Metrics types, comma separated |
-| ecom_type | query | string | No | 电商类型/E-commerce type |
-| period_type | query | string | No | 时间类型/Period type |
-| country_code | query | string | No | 国家代码/Country 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/ads/get_query_suggestions`
-
-- Summary: 获取查询建议/Get query suggestions
-- Capabilities: search / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_query_suggestions_api_v1_tiktok_ads_get_query_suggestions_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-query-suggestions`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-query-suggestions)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| count | query | integer | No | 建议数量/Suggestion count |
-| scenario | query | integer | No | 场景类型/Scenario type |
-
-#### 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/ads/get_recommended_ads`
-
-- Summary: 获取推荐广告/Get recommended ads
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_recommended_ads_api_v1_tiktok_ads_get_recommended_ads_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-recommended-ads`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-recommended-ads)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| material_id | query | string | Yes | 广告素材ID/Ad material ID |
-| industry | query | string | No | 行业ID/Industry ID |
-| country_code | query | string | No | 国家代码/Country 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/ads/get_related_keywords`
-
-- Summary: 获取相关关键词/Get related keywords
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_related_keywords_api_v1_tiktok_ads_get_related_keywords_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-related-keywords`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-related-keywords)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| keyword | query | string | No | 目标关键词/Target keyword |
-| period | query | integer | No | 时间段（天）/Time period (days, 7/30/120) |
-| country_code | query | string | No | 国家/地区代码/Country code |
-| rank_type | query | string | No | 排名类型/Rank type (popular: 热门, breakout: 突破性) |
-| content_type | query | string | No | 内容类型/Content type (keyword, hashtag) |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-
-#### 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/ads/get_sound_detail`
-
-- Summary: 获取音乐详情/Get sound detail
-- Capabilities: details / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_sound_detail_api_v1_tiktok_ads_get_sound_detail_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-sound-detail`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-sound-detail)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| clip_id | query | string | Yes | 音乐ID/Sound clip ID |
-| period | query | integer | No | 时间范围（天）/Time period (days) |
-| country_code | query | string | No | 国家代码/Country 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/ads/get_sound_filters`
-
-- Summary: 获取音乐筛选器/Get sound filters
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_sound_filters_api_v1_tiktok_ads_get_sound_filters_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-sound-filters`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-sound-filters)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| rank_type | query | string | No | 排行类型/Rank type (popular, surging) |
-
-#### 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/ads/get_sound_rank_list`
-
-- Summary: 获取热门音乐排行榜/Get popular sound rankings
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_sound_rank_list_api_v1_tiktok_ads_get_sound_rank_list_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-sound-rank-list`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-sound-rank-list)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| period | query | integer | No | 时间范围（天）/Time period (days) |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| rank_type | query | string | No | 排行类型/Rank type (popular, surging) |
-| new_on_board | query | boolean | No | 是否只看新上榜/Only new on board |
-| commercial_music | query | boolean | No | 是否商业音乐/Commercial music only |
-| country_code | query | string | No | 国家代码/Country 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/ads/get_sound_recommendations`
-
-- Summary: 获取音乐推荐/Get sound recommendations
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_sound_recommendations_api_v1_tiktok_ads_get_sound_recommendations_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-sound-recommendations`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-sound-recommendations)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| clip_id | query | string | Yes | 参考音乐ID/Reference sound clip ID |
-| limit | query | integer | No | 推荐数量/Number of recommendations |
-
-#### 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/ads/get_top_ads_spotlight`
-
-- Summary: 获取热门广告聚光灯/Get top ads spotlight
-- Capabilities: ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_top_ads_spotlight_api_v1_tiktok_ads_get_top_ads_spotlight_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-top-ads-spotlight`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-top-ads-spotlight)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| industry | query | string | No | 行业ID/Industry ID |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-
-#### 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/ads/get_top_products`
-
-- Summary: 获取热门产品列表/Get top products list
-- Capabilities: commerce / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_top_products_api_v1_tiktok_ads_get_top_products_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-top-products`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-get-top-products)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| last | query | integer | No | 最近天数/Last days |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| country_code | query | string | No | 国家代码/Country code |
-| first_ecom_category_id | query | string | No | 电商类目ID，多个用逗号分隔/E-commerce category IDs, comma separated |
-| ecom_type | query | string | No | 电商类型/E-commerce type (l3) |
-| period_type | query | string | No | 时间类型/Period type (last) |
-| order_by | query | string | No | 排序字段/Sort field (post, ctr, cvr) |
-| order_type | query | string | No | 排序方式/Sort order (desc, asc) |
-
-#### 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/ads/search_ads`
-
-- Summary: 搜索广告/Search ads
-- Capabilities: search / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `search_ads_api_v1_tiktok_ads_search_ads_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-search-ads`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-search-ads)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| objective | query | integer | No | 广告目标类型/Ad objective (1:流量 2:应用安装 3:转化 4:视频浏览 5:触达 6:潜在客户 7:产品销售) |
-| like | query | integer | No | 表现排名/Performance rank (1:前1-20% 2:前21-40% 3:前41-60% 4:前61-80%) |
-| period | query | integer | No | 时间段/Time period (days) |
-| industry | query | string | No | 行业ID/Industry ID |
-| keyword | query | string | No | 搜索关键词/Search keyword |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| order_by | query | string | No | 排序方式/Sort by (for_you, likes) |
-| country_code | query | string | No | 国家代码/Country code |
-| ad_format | query | integer | No | 广告格式/Ad format (1:视频) |
-| ad_language | query | string | No | 广告语言/Ad language |
-| search_id | query | string | No | 搜索ID（可选）/Search ID (optional) |
-
-#### 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/ads/search_creators`
-
-- Summary: 搜索创作者/Search creators
-- Capabilities: search / creators / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `search_creators_api_v1_tiktok_ads_search_creators_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-search-creators`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-search-creators)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| keyword | query | string | Yes | 搜索关键词/Search keyword |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| sort_by | query | string | No | 排序方式/Sort by (follower, avg_views) |
-| creator_country | query | string | No | 创作者国家/Creator country |
-
-#### 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/ads/search_sound`
-
-- Summary: 搜索音乐/Search sounds
-- Capabilities: search / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `search_sound_api_v1_tiktok_ads_search_sound_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-search-sound`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-search-sound)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| keyword | query | string | Yes | 搜索关键词/Search keyword |
-| period | query | integer | No | 时间范围（天）/Time period (days) |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| rank_type | query | string | No | 排行类型/Rank type (popular, surging) |
-| new_on_board | query | boolean | No | 是否只看新上榜/Only new on board |
-| commercial_music | query | boolean | No | 是否商业音乐/Commercial music only |
-| country_code | query | string | No | 国家代码/Country 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/ads/search_sound_hint`
-
-- Summary: 搜索音乐提示/Search sound hints
-- Capabilities: search / ads
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `search_sound_hint_api_v1_tiktok_ads_search_sound_hint_get`
-- Full contract: [`api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-search-sound-hint`](../api-contracts/tiktok-ads-api.md#get-api-u1-v1-tiktok-ads-search-sound-hint)
-
-#### Parameters
-
-| Field | In | Type | Required | Description |
-| --- | --- | --- | --- | --- |
-| keyword | query | string | Yes | 搜索关键词/Search keyword |
-| period | query | integer | No | 时间范围（天）/Time period (days) |
-| page | query | integer | No | 页码/Page number |
-| limit | query | integer | No | 每页数量/Items per page |
-| rank_type | query | string | No | 排行类型/Rank type (popular, surging) |
-| country_code | query | string | No | 国家代码/Country code |
-| filter_by_checked | query | boolean | No | 是否只看已验证/Only verified |
-| commercial_music | query | boolean | No | 是否商业音乐/Commercial music only |
-
-#### 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.