{ "openapi": "3.0.1", "info": { "title": "YouTube Video Downloader - MP4 & MP3", "description": "Download YouTube videos and Shorts directly to your device in MP4 or MP3 format. Supports batch downloads, quality selection from 360p to 1080p, and audio-only extraction. Powered by yt-dlp for reliable downloads. Pay per minute — only charged on successful downloads.", "version": "0.0", "x-build-id": "aB2ftzj2Rewdkad51" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/marielise.dev~youtube-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-marielise.dev-youtube-video-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/marielise.dev~youtube-video-downloader/runs": { "post": { "operationId": "runs-sync-marielise.dev-youtube-video-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/marielise.dev~youtube-video-downloader/run-sync": { "post": { "operationId": "run-sync-marielise.dev-youtube-video-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": [ "urls" ], "properties": { "urls": { "title": "YouTube URLs", "type": "array", "description": "One or more YouTube video or Shorts URLs. Accepts youtube.com/watch?v=..., youtube.com/shorts/..., youtu.be/... and embed links. Playlist and channel URLs are not expanded; add each video separately. Videos are processed one at a time.", "default": [ { "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "quality": { "title": "Maximum video quality", "enum": [ "360", "480", "720", "1080" ], "type": "string", "description": "Upper bound for the video resolution. The best stream up to this limit is downloaded, and you are billed at the quality actually delivered, so asking for 1080p on a 720p-only video bills at 720p. Lower quality means smaller files and faster runs. For Shorts, 720p succeeds more often than 1080p on the standard path.", "default": "1080" }, "format": { "title": "Output format", "enum": [ "default", "mp3" ], "type": "string", "description": "MP4 video with audio, or MP3 audio only. MP3 ignores the quality setting and bills $0.01 per minute.", "default": "default" }, "residentialProxyMode": { "title": "Residential proxy fallback (paid, off by default)", "enum": [ "disabled", "fallback" ], "type": "string", "description": "Last-resort residential proxy used only after every free attempt is blocked by YouTube. Billed at $0.05 per MB of proxy bandwidth (5 MB minimum per video), including bandwidth used by attempts that fail. Nothing is billed when the fallback is never triggered. Set a Max total charge in Run options when you enable it.", "default": "disabled" }, "proxyCountry": { "title": "Residential proxy country", "enum": [ "", "US", "GB", "DE", "FR", "CA", "AU", "JP", "BR", "IN", "NL" ], "type": "string", "description": "Country of the residential proxy exit. Only used when the residential fallback is enabled. Leave on Auto unless the video is region-locked.", "default": "" }, "customProxyUrl": { "title": "Custom proxy URL (bring your own)", "type": "string", "description": "Your own HTTP proxy, for example a Bright Data, Decodo or IPRoyal residential endpoint, as http://user:pass@host:port. When set, every download goes through it, the Apify residential fallback is skipped and no proxy bandwidth is billed. You pay only the per-minute rate. Stored as a secret." }, "youtubeCookies": { "title": "YouTube cookies (Netscape cookies.txt)", "type": "string", "description": "Contents of a cookies.txt file exported from a logged-in YouTube session. Unlocks age-restricted and members-only videos you have access to and improves success on videos YouTube throttles for anonymous downloaders. Use a throwaway account, not your main one. Export with the Get cookies.txt browser extension or yt-dlp --cookies-from-browser. Stored as a secret and deleted after the run." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }