[中文]

用途:

• 按关键词搜索视频（V5 版本），只返回视频内容。
• 翻页参数与综合搜索 V3 一致，响应结构统一（config + items + pagination）。

备注:

• 首次请求 offset 传 0、page 传 1，search_id 与 backtrace 传空字符串。
• 翻页时把上一次响应 data.pagination 里的 offset、search_id、backtrace 原样传回，并把 page 加 1。
• data.pagination.has_more 为 0 表示已经到最后一页。
• 每页固定 10 条，不支持指定数量。page 上限为 200，超出会返回参数错误。

参数:

• keyword: 搜索关键词，如 "猫咪"
• offset: 翻页游标（首次请求传 0）
• page: 页码，取值 1~200（首次请求传 1）
• search_id: 搜索ID（首次请求传空字符串）
• backtrace: 翻页回溯标识（首次请求传空字符串）

请求体示例：

payload = {
    "keyword": "猫咪",
    "offset": 0,
    "page": 1,
    "search_id": "",
    "backtrace": ""
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

• config: 本次搜索的配置信息（透传）
• items[]: 视频列表（已按卡片类型解包）
  • aweme_id: 视频ID
  • desc: 视频描述
  • create_time: 发布时间（时间戳）
  • author: 作者信息（uid、sec_uid、nickname、avatar_thumb.url_list 等）
  • video: 播放信息（play_addr.url_list、cover.url_list、duration 等）
  • statistics: 互动数据（digg_count、comment_count、share_count、play_count）
  • share_url: 视频分享链接
• pagination: 翻页信息
  • offset: 下一页的翻页游标（原样传回）
  • cursor: 同 offset
  • search_id: 下一页的搜索ID（原样传回）
  • backtrace: 下一页的回溯标识（原样传回）
  • has_more: 是否还有更多数据（1=有，0=无）
  • next_page: 下一页页码（没有更多数据时为 null）

[English]

Purpose:

• Search videos by keyword (V5), returning video content only.
• Pagination parameters match general search V3, and the response structure is unified (config + items + pagination).

Notes:

• For the first request set offset to 0, page to 1, and search_id / backtrace to empty strings.
• For pagination, pass back offset, search_id and backtrace from data.pagination of the previous response, and increment page by 1.
• data.pagination.has_more = 0 means the last page has been reached.
• Page size is fixed at 10 and cannot be changed. page is capped at 200; exceeding it returns a parameter error.

Parameters:

• keyword: Search keyword, e.g., "cat"
• offset: Offset cursor (0 for the first request)
• page: Page number, 1-200 (1 for the first request)
• search_id: Search ID (empty for the first request)
• backtrace: Backtrace identifier (empty for the first request)

Request Body Example:

payload = {
    "keyword": "cat",
    "offset": 0,
    "page": 1,
    "search_id": "",
    "backtrace": ""
}

Response (common fields, actual response may contain more fields):

• config: Search configuration returned by the upstream (passed through)
• items[]: Video list (already unwrapped by card type)
  • aweme_id: Video ID
  • desc: Video description
  • create_time: Publish timestamp
  • author: Author info (uid, sec_uid, nickname, avatar_thumb.url_list, etc.)
  • video: Playback info (play_addr.url_list, cover.url_list, duration, etc.)
  • statistics: Interaction data (digg_count, comment_count, share_count, play_count)
  • share_url: External share link
• pagination: Pagination info
  • offset: Offset cursor for the next page (pass back as-is)
  • cursor: Same as offset
  • search_id: Search ID for the next page (pass back as-is)
  • backtrace: Backtrace for the next page (pass back as-is)
  • has_more: Whether more results are available (1=Yes, 0=No)
  • next_page: Next page number (null when there are no more results)