{"openapi":"3.2.0","info":{"title":"YouTube to MP3 - Audio Converter API","description":"Convert any YouTube video to MP3 320KBPS. Submit a video ID, poll the job, download the audio file","version":"1.0.0"},"servers":[{"url":"https://youtube-to-mp3.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Convert"}],"x-agent-commerce":{"catalog_url":"https://youtube-to-mp3.jojapi.net/_jojapi/agent/plans","discovery_url":"https://youtube-to-mp3.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/youtube-to-mp3","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/api/v1/quick":{"post":{"operationId":"post_api_v1_quick","summary":"quickConvert","description":"Provide the 11-character YouTube video **id**. Optionally set **bitrateKbps** (defaults to 320). Call repeatedly with the same id to poll: `processing` while it runs, then `ok` with a download `link`.","tags":["Convert"],"responses":{"200":{"description":"Either the finished result (`status: ok`), an in-progress poll (`status: processing`), or a job that failed (`status: error`).","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"link":{"type":"string","description":"Absolute URL to download the finished MP3."},"filesize":{"type":"integer","description":"Size in bytes."},"progress":{"type":"integer"},"duration":{"type":"integer","description":"Audio duration in seconds."},"title":{"type":"string"},"videoId":{"type":"string"},"bitrateKbps":{"type":"integer"},"format":{"type":"string"},"downloadFilename":{"type":"string"}}},{"type":"object","properties":{"status":{"type":"string","enum":["processing"]},"progress":{"type":"integer","minimum":0,"maximum":100},"videoId":{"type":"string"},"bitrateKbps":{"type":"integer"},"format":{"type":"string"}}},{"type":"object","properties":{"status":{"type":"string","enum":["error"]},"progress":{"type":"integer"},"error":{"type":"string"},"videoId":{"type":"string"},"bitrateKbps":{"type":"integer"},"format":{"type":"string"}}}]},"examples":{"ok":{"value":{"status":"ok","link":"https://api2.yt2mp3converter.net/api/v1/download/036819e9-4f00-4cb3-89be-376a31bd3a64?name=SAKHIYAAN_Full_Song.mp3","filesize":7958400,"progress":100,"duration":199,"title":"SAKHIYAAN Full Song Maninder Buttar","videoId":"LfAd6mGd81M","bitrateKbps":320,"format":"mp3","downloadFilename":"SAKHIYAAN_Full_Song.mp3"}},"error":{"value":{"status":"error","progress":0,"error":"BOT_CHALLENGE: Sign in to confirm you're not a bot","videoId":"LfAd6mGd81M","bitrateKbps":320,"format":"mp3"}}}}}},"202":{"description":"Job accepted / still processing. Keep polling.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["processing"]},"progress":{"type":"integer","minimum":0,"maximum":100},"videoId":{"type":"string"},"bitrateKbps":{"type":"integer"},"format":{"type":"string"}}},"examples":{"Example_1":{"value":{"status":"processing","progress":0,"videoId":"LfAd6mGd81M","bitrateKbps":320,"format":"mp3"}}}}}},"400":{"description":"Invalid id or bitrate.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"detail":{"type":["object","null"]}}},"examples":{"Example_1":{"value":{"error":"invalid input"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"detail":{"type":["object","null"]}}},"examples":{"Example_1":{"value":{"error":"invalid or missing api key"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_-]{11}$","description":"The 11-character YouTube video id (the `v=` value in a watch URL)."},"format":{"type":"string","enum":["mp3"],"default":"mp3","description":"Output audio format. Only mp3 is supported."},"bitrateKbps":{"type":"integer","minimum":32,"maximum":320,"default":320,"description":"Optional MP3 bitrate. Defaults to 320 kbps."}}},"example":{"id":"LfAd6mGd81M","format":"mp3","bitrateKbps":320}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}