{ "openapi": "3.0.1", "info": { "title": "YouTube to MP3 Audio Downloader", "description": "Download YouTube audio as MP3, AAC (M4A), or WAV. Paste one or more links, pick format and bitrate, get permanent download links. Supports playlists, Shorts, and batch processing.", "version": "0.0", "x-build-id": "MzTnxC91grG8lXJC2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lurkapi~youtube-to-mp3-audio-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lurkapi-youtube-to-mp3-audio-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/lurkapi~youtube-to-mp3-audio-downloader/runs": { "post": { "operationId": "runs-sync-lurkapi-youtube-to-mp3-audio-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/lurkapi~youtube-to-mp3-audio-downloader/run-sync": { "post": { "operationId": "run-sync-lurkapi-youtube-to-mp3-audio-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "videoUrls" ], "properties": { "videoUrls": { "title": "YouTube URLs", "type": "array", "description": "Paste your YouTube links here. Supports video URLs, short links (youtu.be/...), Shorts, and playlist URLs.", "items": { "type": "string" } }, "audioFormat": { "title": "Audio Format", "enum": [ "mp3", "m4a", "wav", "aac", "flac", "opus", "vorbis", "alac" ], "type": "string", "description": "Select the audio output format. MP3 is the most compatible. M4A (AAC) has better quality at the same bitrate. FLAC and WAV are lossless. OPUS and Vorbis are efficient compressed formats. ALAC is Apple's lossless format.", "default": "mp3" }, "audioBitrate": { "title": "Audio Quality (Bitrate)", "enum": [ "source", "auto", "320k", "256k", "192k", "128k", "64k" ], "type": "string", "description": "Audio bitrate. 'source' keeps the original YouTube audio with no re-encode (best quality, m4a or webm container — fastest too). 'auto' lets the tool pick a sensible default. Specific bitrates (e.g. 320k) transcode; output will never exceed source bitrate so asking for 320k on a 130k source yields ~130k. Lossless formats (WAV/FLAC/ALAC) ignore this setting.", "default": "auto" }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of parallel downloads. Auto-scales with memory: 1 at 1024 MB, 4 at 2048 MB, 8 at 4096 MB. Leave empty to auto-scale, or set explicitly to override. For batches over 10 videos, increase memory to 2048 MB+ for noticeably faster runs." }, "embedMetadata": { "title": "Embed Metadata & Album Art", "type": "boolean", "description": "Embed title, artist, and album art (thumbnail) directly into the audio file. Increases file size by 100-500 KB depending on the thumbnail. Works with MP3, M4A, AAC, FLAC, OPUS, Vorbis, and ALAC. WAV does not support embedded artwork.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxy to route requests through YouTube. Recommended for reliable downloads.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }