{ "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": "VSejmbI1INv7wAqQD" }, "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" }, "maxVideosPerUrl": { "title": "Max videos per URL", "minimum": 1, "maximum": 5000, "type": "integer", "description": "When a URL is a playlist, Mix, or radio queue, expand at most this many videos from it. Use this to cap how many downloads a single playlist URL can trigger. Regular single-video URLs are not affected. Range 1–5000.", "default": 2000 }, "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 } } } } } } } } } }