--- title: "综合搜索V2/General search V2" method: GET path: "/api/v1/youtube/web_v2/get_general_search_v2" tags: ["YouTube-Web-V2-API"] --- # 综合搜索V2/General search V2 `GET /api/v1/youtube/web_v2/get_general_search_v2` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/youtube/web_v2/get_general_search_v2` - Auth: HTTP bearer # [中文] ### 用途: - 搜索 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 ## Query parameters - `keyword` string, nullable: 搜索关键词（首次请求必填）/Search keyword (required for first request) - `continuation_token` string, nullable: 分页token，用于获取下一页/Continuation token for next page - `upload_date` 'last_hour' | 'today' | 'this_week' | 'this_month' | 'this_year', nullable: 上传时间过滤/Upload date filter - `type` 'video' | 'channel' | 'playlist' | 'movie', nullable: 类型过滤/Type filter - `duration` 'short' | 'medium' | 'long', nullable: 时长过滤/Duration filter: short (<4min), medium (4-20min), long (>20min) - `features` string, nullable: 特性过滤（逗号分隔）/Feature filter (comma separated): live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr - `sort_by` 'relevance' | 'upload_date' | 'view_count' | 'rating', nullable: 排序方式/Sort by ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 2 info - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200` - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200` - **2026-04-14** `ee5b7c9c88f5`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/youtube/web_v2/get_general_search_v2/get.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)