Video search
GET /api/search-videosLive video search: ranked video results (title, video page URL, description, duration, creator, publisher, thumbnail, age) from an independent search index as clean JSON. Completes the web/news/images search family. Same freshness filter (pd/pw/pm/py); strict safe-search is on by default.
Input
| Field | Type | Description |
|---|---|---|
q * | string | Search query (max 400 chars) |
count | number | Results to return, 1-50 (default 10) |
freshness | string | Optional: pd, pw, pm, or py (past day/week/month/year) |
safesearch | string | Optional: 'strict' (default) or 'off' |
country | string | Optional 2-letter country code (default US) |
Example output
{
"query": "agent payments",
"count": 2,
"results": [
{
"title": "The future of agentic payments",
"url": "https://www.youtube.com/watch?v=example",
"description": "How payment infrastructure for AI agents is built…",
"age": "March 23, 2026",
"duration": "14:58",
"creator": "Example Channel",
"publisher": "YouTube",
"thumbnail": "https://imgs.search.brave.com/..."
}
]
}
Try it — see the 402 challenge (free)
curl -i "https://agent402.tools/api/search-videos?q=agent+payments&count=5"
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/search-videos?q=agent+payments&count=5");
Related tools
Extract article
POST /api/extractExtract the main article content from any public URL as clean markdown. Returns title, byline, excerpt, word count, and …
Page metadata
GET /api/metaFetch page metadata for a URL: title, description, OpenGraph, Twitter cards, canonical URL, favicon.
Browser render
POST /api/renderRender a page in a real headless Chromium browser (JavaScript executed), then extract the main content as clean markdown…