{"uid":"cap_2PZXJPwDtuGdCicG2wQoQ","slug":"video-download-ai-media-retrieval-api-8b9eaa85","name":"Video Download AI — Media Retrieval API","description":"An agent-native media retrieval API with x402 payments, duration-only pricing, and a 60-minute media limit.","url":"https://video-download.ai/api/download","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":2048,"minLength":1,"description":"Public HTTP or HTTPS media page URL supported by yt-dlp."},"format":{"enum":["mp4","mp3"],"type":"string","default":"mp4","description":"MP4 video or MP3 audio output."},"quality":{"enum":["1080","720","480","360"],"type":"string","default":"1080","description":"Maximum requested video height; ignored for MP3 output."},"paymentNetwork":{"enum":["base"],"type":"string","default":"base","description":"USDC payment network."}}},"responseSchema":{"type":"binary","format":"video/mp4 or audio/mpeg","example":"<binary media response body>"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__ZQvIyKIiT8JOZ6id0iLF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Downloads a video or audio file from a public media page URL (via yt-dlp) and returns the binary media content in MP4 or MP3 format.","exampleAgentPrompt":"Download this YouTube video for me as a 720p MP4 file: https://www.youtube.com/watch?v=dQw4w9WgXcQ","exampleUseCases":[{"title":"Offline video archive for research","prompt":"Can you download this documentary clip as a 1080p MP4 from this URL so I can review it offline? https://www.youtube.com/watch?v=exampleDocumentary"},{"title":"Audio extraction for podcast workflow","prompt":"Pull the audio from this interview video as an MP3 so I can transcribe it — the URL is https://www.youtube.com/watch?v=exampleInterview"},{"title":"Low-bandwidth video download for mobile","prompt":"Download this tutorial video at 360p MP4 quality from https://www.youtube.com/watch?v=exampleTutorial — I need a smaller file size."}],"resultDescription":"A binary file body containing either a video/mp4 or audio/mpeg stream, ready to be saved or piped directly to downstream processing. No JSON wrapper — the response body is the raw media content.","failureModes":["Unsupported URL: yt-dlp cannot extract from the given media page, returns an error","URL exceeds 60-minute media duration limit, request rejected","Invalid format or quality enum value supplied","Payment failure on Base network via x402, request not processed","Private or geo-restricted content that yt-dlp cannot access","Malformed or non-HTTP/HTTPS URL rejected by schema validation"],"whenToPreferThis":"Choose this endpoint when you need to retrieve a binary media file (video or audio) from a public media page URL supported by yt-dlp, especially when you need a specific resolution or audio-only output and are operating in an agent context with x402 micropayment support on Base network. Prefer over generic scraping tools when the goal is a downloadable media asset rather than page text or metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T17:51:30.269Z","isFirstParty":false}