Video Search API

Search videos across YouTube and Google Videos with filtering, geographic targeting, and pagination support.

POST/v1/video/*

YouTube 搜索

POST/v1/video/youtube

按关键词搜索 YouTube 视频，支持国家、语言和分页/过滤。

参数

参数	类型	必填	描述
`q`	string	必填	搜索关键词
`country`	string	可选	国家代码过滤
`language`	string	可选	语言过滤
`sp`	string	可选	分页/过滤参数

Google 视频搜索

POST/v1/video/google-videos

在 Google 上搜索视频，支持地理定位、时间过滤、语言设置和安全搜索。

参数

参数	类型	必填	描述
`q`	string	必填	搜索关键词
`location`	string	可选	地理定位
`language`	string	可选	语言过滤
`page`	integer	可选 (默认: 0)	分页页码
`safe`	string	可选	安全搜索设置

响应字段说明

/v1/video/youtube响应格式: JSON

字段	类型	说明
`success`	boolean	请求是否成功。
`message`	string	本次处理结果的摘要信息。
`data`	object \| null	上游服务返回的数据；失败时通常为 null。
`error.code`	string	失败时的机器可读错误码。
`error.details`	string	失败原因详情。
`data.video_results[]`	object[]	YouTube 视频结果。
`data.video_results[].title / link`	string	视频标题和链接。
`data.video_results[].length`	string	视频时长。
`data.video_results[].views`	string	格式化播放量。
`data.video_results[].published_date`	string	发布时间。
`data.video_results[].channel`	object	频道名称、链接及认证状态。
`data.video_results[].thumbnail`	object	静态或动态缩略图地址。

/v1/video/google-videos响应格式: JSON

字段	类型	说明
`success`	boolean	请求是否成功。
`message`	string	本次处理结果的摘要信息。
`data`	object \| null	上游服务返回的数据；失败时通常为 null。
`error.code`	string	失败时的机器可读错误码。
`error.details`	string	失败原因详情。
`data.videos_results[]`	object[]	Google 视频结果。注意字段名为 videos_results。
`data.videos_results[].title / link`	string	视频标题和来源链接。
`data.videos_results[].thumbnail`	string	缩略图 URL。
`data.videos_results[].displayed_link`	string	展示用来源地址。
`data.videos_results[].time`	string	视频时长或时间信息。
`data.videos_results[].rank`	integer	结果排名。
`data.pagination`	object	分页信息。

响应

Response

{
  "success": true,
  "message": "YouTube search completed successfully",
  "data": {
    "video_results": [
      {
        "title": "Transformers Explained - Machine Learning",
        "channel": "3Blue1Brown",
        "views": "5.2M views",
        "published": "1 year ago",
        "link": "https://youtube.com/watch?v=...",
        "thumbnail": "https://i.ytimg.com/vi/.../hqdefault.jpg"
      }
    ]
  }
}

示例

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.qinyanai.com"

# YouTube search
response = requests.post(
    f"{BASE_URL}/v1/video/youtube",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"q": "transformer architecture explained", "country": "US"}
)

# Google Videos search
response = requests.post(
    f"{BASE_URL}/v1/video/google-videos",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"q": "deep learning tutorial", "language": "en"}
)