Give an agent a public YouTube URL. Get clean transcript text, timestamped segments, model-sized chunks, and source citations in a single JSON response.
POST /v1/youtube/transcript
content-type: application/json
{
"url": "https://youtube.com/watch?v=…",
"language": "en",
"maxChunkCharacters": 2400
}{
"video": { "id": "…", "title": "…" },
"transcript": {
"language": "en",
"source": "manual",
"segments": [ … ]
},
"chunks": [{
"text": "Agent-ready context…",
"citation": {
"label": "2:14–2:52",
"url": "https://youtube.com/watch?v=…&t=134s"
}
}]
}Fund a Base wallet with USDC, keep its signer in your own process, and let the x402 client handle the quote, signature, and retry.
x402 buyer guide ↗npm install @x402/core @x402/fetch @x402/evm viemimport { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";
const signer = privateKeyToAccount(
process.env.EVM_PRIVATE_KEY as `0x${string}`,
);
const client = new x402Client().register(
"eip155:8453",
new ExactEvmScheme(signer),
);
const paidFetch = wrapFetchWithPayment(fetch, client);
const result = await paidFetch(
"https://transcript.melchiorlabs.com/v1/youtube/transcript",
{
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({
url: "https://www.youtube.com/watch?v=…",
language: "en",
}),
},
);
console.log(await result.json());/v1/youtube/transcriptExtract available captions from a public YouTube video and package them as structured context with deep-linked timestamp citations.
/v1/youtube/searchFind transcript passages that match a phrase or terms and return only the strongest evidence with source deep links.
/v1/transcripts/contextTurn supplied text, WebVTT, SRT, or timestamped segments into model-sized chunks without calling YouTube.
Send the video URL and language.
Your client signs the x402 requirement.
Inject cited chunks into the agent context.
Citations, not mystery text. Every chunk carries its time range and a deep link to the source moment.
Pay only on success. x402 settlement happens after a successful handler response. Captionless and unavailable videos return errors without settlement.
Discoverable by other agents. All three resources declare exact Bazaar schemas, examples, pricing, and service metadata.