视频搜索

通过 x402 按次付费（HTTP 402）的付费视频搜索代理。

前置条件：此技能需要 x402 支付。首次使用前请完成设置步骤。
安全性：仅提供文档——不包含可执行代码或凭证。钱包/密钥保留在您的机器上；绝不存储在此处。

服务 URL

角色	域名
API 提供商	https://www.cpbox.io
协调方

https://www.cppay.finance |

端点（代理接口）

http
GET /api/x402/videos-search
POST /api/x402/videos-search/post

支付流程（x402 协议）

1. 1. 首次请求 -> 返回 402 Payment Required 及需求 JSON
2. 签名并重试，携带 PAYMENT-SIGNATURE -> 返回结果 JSON

使用 @springmint/x402-payment 或 x402-sdk-go 时，支付自动完成。

快速开始（cURL）

基础搜索

bash curl -s https://www.cpbox.io/api/x402/videos-search?q=python+tutorial \ -H Accept: application/json

带参数搜索

bash curl -s https://www.cpbox.io/api/x402/videos-search \ -H Accept: application/json \ -G \ --data-urlencode q=machine learning explained \ --data-urlencode country=US \ --data-urlencode search_lang=en \ --data-urlencode count=20 \ --data-urlencode freshness=pm

使用 x402-payment

bash
npx @springmint/x402-payment \
--url https://www.cpbox.io/api/x402/videos-search?q=python+tutorial&count=20 \
--method GET

参数

参数	类型	必填	默认值	描述
q	string	是	-	搜索查询（1-400 字符，最多 50 个单词）
country

string | 否 | US | 搜索国家（2 字母国家代码或 ALL） | | search_lang | string | 否 | en | 语言偏好（2 个以上字符的语言代码） | | ui_lang | string | 否 | en-US | 界面语言（例如 en-US） | | count | int | 否 | 20 | 结果数量（1-50） | | offset | int | 否 | 0 | 分页偏移量（0-9） | | safesearch | string | 否 | moderate | 成人内容过滤器（off/moderate/strict） | | freshness | string | 否 | - | 时间过滤器（pd/pw/pm/py 或日期范围） | | spellcheck | bool | 否 | true | 自动纠正查询 | | operators | bool | 否 | true | 应用搜索运算符 | | includefetchmetadata | bool | 否 | false | 在结果中包含 fetchedcontenttimestamp |

新鲜度值

值	描述
pd	过去一天（24 小时）
pw

过去一周（7 天） | | pm | 过去一个月（31 天） | | py | 过去一年（365 天） | | YYYY-MM-DDtoYYYY-MM-DD | 自定义日期范围 |

响应格式

json
{
type: videos,
query: {
original: python tutorial,
spellcheck_off: false
},
extra: {
mightbeoffensive: false
},
results: [
{
type: video_result,
title: Python Tutorial for Beginners,
url: https://www.youtube.com/watch?v=rfscVS0vtbw,
description: Learn Python programming from scratch...,
age: February 12, 2025,
page_age: 2025-02-12T00:00:00,
page_fetched: 2025-02-12T15:00:00Z,
thumbnail: {
src: https://imgs.search.provider/...,
original: https://i.ytimg.com/vi/rfscVS0vtbw/hqdefault.jpg
},
video: {
duration: 03:45:00,
views: 1523000,
creator: freeCodeCamp,
publisher: YouTube,
requires_subscription: false,
tags: [python, programming],
author: {
name: freeCodeCamp.org,
url: https://www.youtube.com/@freecodecamp
}
},
meta_url: {
scheme: https,
netloc: youtube.com,
hostname: www.youtube.com,
favicon: https://imgs.search.provider/...,
path: \u203a watch
}
}
]
}

响应字段

字段	类型	描述
type	string	始终为 videos
query.original

string | 原始搜索查询 | | query.altered | string? | 拼写检查修正后的查询（如有变化） | | query.cleaned | string? | 清理/标准化后的查询 | | query.spellcheck_off | bool? | 拼写检查是否已禁用 | | query.showstrictwarning | bool? | 严格安全搜索阻止成人结果时为 true | | query.searchoperators | object? | 应用的搜索运算符（applied、cleanedquery、sites） | | extra.mightbeoffensive | bool | 结果是否可能包含冒犯性内容 | | results[].type | string | 始终为 video_result | | results[].url | string | 视频的源 URL | | results[].title | string | 视频标题 | | results[].description | string? | 视频描述 | | results[].age | string? | 人类可读的时长（例如 6 months ago）或绝对日期（例如 February 12, 2025） | | results[].page_age | string? | 来自源的页面时长（ISO 日期时间） | | results[].page_fetched | string? | 页面最后获取时的 ISO 日期时间（例如 2025-02-12T15:00:00Z） | | results[].fetchedcontenttimestamp | int? | 获取时间戳（仅在 includefetchmetadata=true 时） | | results[].video.duration | string? | 时间字符串（格式可变） | | results[].video.views | int? | 观看次数（整数） | | results[].video.creator | string? | 频道/创作者名称 | | results[].video.publisher | string? | 平台（YouTube、Vimeo 等） | | results[].video.requires_subscription | bool? | 视频是否需要订阅 | | results[].video.tags | list[str]? | 与视频相关的标签 | | results[].video.author | object? | 作者资料 | | results[].video.author.name | string | 作者名称 | | results[].video.author.url | string | 作者资料 URL | | results[].video.author.long_name | string? | 扩展作者名称 | | results[].video.author.img | string? | 作者资料图片 URL | | results[].thumbnail.src | string | 提供的缩略图 URL | | results[].thumbnail.original | string? | 原始缩略图 URL | | results[].meta_url.scheme | string? | URL 协议方案 | | results[].meta_url.netloc | string? | 网络位置 | | results[].meta_url.hostname | string? | 小写域名 | | results[].meta_url