综合搜索V2/General search V2

[中文]

用途:

• 搜索 YouTube 视频、Shorts、频道、播放列表
• 返回清洗后的结构化数据（相比 get_general_search 返回原始数据）
• 支持多种过滤条件和排序方式
• 支持分页加载更多结果

参数:

• keyword: 搜索关键词（首次请求必填）
• continuation_token: 分页token（获取下一页时传入，从上一次返回结果中获取）
• upload_date: 上传时间过滤 - last_hour/today/this_week/this_month/this_year
• type: 结果类型过滤 - video/channel/playlist/movie
• duration: 视频时长过滤 - short(<4分钟)/medium(4-20分钟)/long(>20分钟)
• features: 特性过滤（多个用逗号分隔）- live/4k/hd/subtitles/creative_commons/360/vr180/3d/hdr
• sort_by: 排序方式 - relevance(相关性)/upload_date(上传日期)/view_count(播放量)/rating(评分)

返回数据:

• videos: 视频列表（标题、时长、播放量、作者、频道ID、缩略图等）
• shorts: Shorts 短视频列表
• channels: 频道列表
• playlists: 播放列表
• continuation_token: 下一页 token
• completion_suggestions: 搜索建议词

使用流程:

1. 首次搜索传入 keyword（可选过滤参数）
2. 加载更多时传入上一次返回的 continuation_token

[English]

Purpose:

• Search YouTube videos, Shorts, channels, and playlists
• Returns cleaned structured data (compared to get_general_search which returns raw data)
• Supports multiple filter conditions and sorting options
• Supports pagination for loading more results

Parameters:

• keyword: Search keyword (required for first request)
• continuation_token: Pagination token (pass from previous response for next page)
• upload_date: Upload date filter - last_hour/today/this_week/this_month/this_year
• type: Result type filter - video/channel/playlist/movie
• duration: Video duration filter - short(<4min)/medium(4-20min)/long(>20min)
• features: Feature filter (comma separated) - live/4k/hd/subtitles/creative_commons/360/vr180/3d/hdr
• sort_by: Sort by - relevance/upload_date/view_count/rating

Returns:

• videos: Video list (title, duration, views, author, channel_id, thumbnails, etc.)
• shorts: Shorts video list
• channels: Channel list
• playlists: Playlist list
• continuation_token: Next page token
• completion_suggestions: Search suggestions

Usage flow:

1. First search with keyword (optional filter params)
2. Load more by passing continuation_token from previous response

[示例/Example]

基础搜索: GET /get_general_search_v2?keyword=Python tutorial

带过滤: GET /get_general_search_v2?keyword=Python tutorial&upload_date=this_week&type=video&sort_by=view_count

下一页: GET /get_general_search_v2?continuation_token=xxx

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.