youtube.search.videos — routed: best of 4 providers, own keys first
treg.youtube.search.videosSearch YouTube videos by keyword — provider-native video rows in `videos`
- 价格
- $0.001/success按目录价
- 成功率
- 96.2%近 30 天 · 17,652 次
- 延迟 p50
- ——
- 最后验证
- —尚未验证
POSThttps://toolswitch.dev/v1/tools/treg.youtube.search.videosBeta- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({q}) and sends each provider only the fields it wants. On a miss treg keeps trying providers, cheapest first, within X-Treg-Route-Max-Cost (default $1 per call; misses on per-success providers are free). Options ride as headers, never in the body: X-Treg-Route-Waterfall: 0 (stop at the first miss), X-Treg-Route-Max-Cost: <usd>, X-Treg-Route-Prefer / X-Treg-Route-Exclude: <provider>. The response is {output, raw, _treg: {served_by, tried}}; X-Treg-Served-By names the child.
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 请求体（JSON） | ||||
q | str | 可选 | identity key (part of q) | … |
- 请求体（JSON）
qstr可选identity key (part of q)
示例：
…
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
curl -X POST 'https://toolswitch.dev/v1/tools/treg.youtube.search.videos' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"q":"…"}'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/treg.youtube.search.videos",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("{\"q\":\"…\"}"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/treg.youtube.search.videos", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("{\"q\":\"…\"}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());网关接口为 Beta，地址与鉴权方式可能变更。 示例参数仅为样例数据。 调用按 $0.001/success 计费，已含服务费。