Fetch a YouTube transcript from a video URL or 11-char id (video_id, also accepted as ref

[
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "9MkM5Ra48KFcSv9HDQ8sb3C3r5HjouEwGQ6sp1cx1vde",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xC751344Ee09B5159160173F77D4a1169bCd386A1",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:143",
    "payTo": "0xC751344Ee09B5159160173F77D4a1169bCd386A1",
    "asset": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "language_code": "en",
          "origin": "uploader_provided",
          "video_id": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "output": {
        "example": {
          "content_type": "text/vtt",
          "download_url": "https://...presigned...",
          "expires_at": "2026-04-21T13:00:00Z",
          "language_code": "en",
          "length_chars": 3500,
          "origin": "uploader_provided",
          "size_bytes": 4096,
          "video_id": "dQw4w9WgXcQ"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "description": "Input for POST /youtube/get",
              "properties": {
                "format": {
                  "default": "inline",
                  "description": "'inline' (default): include the transcript in the response when it fits the inline cap; otherwise omit it and set transcript_omitted_reason. 'url': never include the transcript; caller fetches download_url. download_url is always present.",
                  "enum": [
                    "inline",
                    "url"
                  ],
                  "type": "string"
                },
                "language_code": {
                  "default": "en",
                  "description": "ISO 639-1 language code (e.g. 'en', 'de', 'fr')",
                  "maxLength": 10,
                  "minLength": 2,
                  "type": "string"
                },
                "origin": {
                  "default": "uploader_provided",
                  "description": "'uploader_provided' for human captions (default), 'auto_generated' for YouTube auto-captions.",
                  "enum": [
                    "uploader_provided",
                    "auto_generated"
                  ],
                  "type": "string"
                },
                "video_id": {
                  "description": "YouTube video URL or 11-char video id (e.g. https://youtu.be/dQw4w9WgXcQ, https://www.youtube.com/watch?v=dQw4w9WgXcQ, or dQw4w9WgXcQ). Also accepted as `ref` or `url`.",
                  "minLength": 1,
                  "type": "string"
                }
              },
              "required": [
                "video_id"
              ],
              "type": "object"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://surf.cascade.fyi/api/v1/youtube/get"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://surf.cascade.fyi/api/v1/youtube/get");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://surf.cascade.fyi/api/v1/youtube/get")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header