{"uid":"cap_saSXSDLBZdyAIpdZyzIqL","slug":"stabletube-youtube-video-downloader-edae78f6","name":"StableTube YouTube Video Downloader","description":"Create a paid StableTube download job. StableTube downloads the video server-side, uploads the mp4 to S3, and returns a temporary StableTube-owned download URL when ready.","url":"https://stabletube.dev/api/download","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Full YouTube URL of the video to download."},"tier":{"enum":["tube-100mb","tube-500mb","tube-1gb"],"type":"string","description":"Required output size tier: tube-100mb (100 MB, $0.05) | tube-500mb (500 MB, $0.10) | tube-1gb (1 GB, $0.20)."},"type":{"type":"string","const":"stabletube.download","default":"stabletube.download"},"format":{"enum":["mp4"],"type":"string","default":"mp4","description":"Output container format. mp4 only for now."},"quality":{"enum":["360p","720p","1080p"],"type":"string","description":"Required target video quality. The request fails if unavailable."},"clientRequestId":{"type":"string","maxLength":120,"minLength":1,"description":"Optional idempotency key scoped to the paying wallet."}}},"responseSchema":null,"example":{"request":{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","tier":"tube-500mb","type":"stabletube.download","format":"mp4","quality":"720p","clientRequestId":"test-qa-001"},"response":{"tier":"tube-500mb","jobId":"10b55260-6ede-4fe7-a997-2e4b7cee4ba3","price":"0.10","title":"Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)","format":"mp4","status":"complete","quality":"720p","videoId":"dQw4w9WgXcQ","maxBytes":524288000,"mimeType":"video/mp4","expiresAt":"2026-06-18T07:25:11.803Z","downloadUrl":"https://x402-upload-prod.s3.us-east-1.amazonaws.com/uploads/stabletube/videos/dQw4w9WgXcQ/720p/10b55260-6ede-4fe7-a997-2e4b7cee4ba3.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2AUOO7BRDDQPWDEV%2F20260618%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260618T062511Z&X-Amz-Expires=3600&X-Amz-Signature=bc24c0f3e4eeffc90533eb0df4d94198fdd005fe20c5e5fbe5d1fa619c4f08d0&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%3D%22Rick%20Astley%20-%20Never%20Gonna%20Give%20You%20Up%20_Official%20Video_%20_4K%20Remaster_.mp4%22&response-content-type=video%2Fmp4&x-amz-checksum-mode=ENABLED&x-id=GetObject","durationSec":213,"contentLengthBytes":29901608}},"exampleRequest":{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","tier":"tube-500mb","type":"stabletube.download","format":"mp4","quality":"720p","clientRequestId":"test-qa-001"},"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.92","successRate":"0.98","reviews":2,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qs9W8svkXj6MGYhbAH2qy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Downloads a YouTube video server-side at a specified quality and returns a temporary S3 URL for the file, billed per call via x402/USDC.","exampleAgentPrompt":"Download this YouTube video for me at 720p — https://www.youtube.com/watch?v=dQw4w9WgXcQ — use the tube-500mb tier and save it as mp4.","exampleUseCases":null,"resultDescription":"A temporary S3 URL pointing to the downloaded MP4 video file, which can be accessed for a limited time after the server-side download completes.","failureModes":["Requested quality (e.g. 1080p) unavailable for the video — returns failure/error","YouTube URL is invalid or video is private/deleted — request fails","Size tier exceeded by actual video size — request may fail or be rejected","Payment not fulfilled via x402 — request blocked","Network or S3 storage issue on server side — transient error"],"whenToPreferThis":"Use this endpoint when you need a server-side YouTube download returned as a temporary S3 link without running a local downloader, especially in agent workflows that need a hosted file URL rather than a local file. Prefer this over browser-based tools or client-side solutions when you need a clean API call with predictable pricing per download.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":139,"lastUsedAt":"2026-07-04T06:57:57.886Z","lastSuccessfullyRanAt":"2026-07-04T06:57:57.886Z","lastHealthCheckAt":"2026-09-14T17:51:23.651Z","isFirstParty":false}