{ "openapi": "3.0.1", "info": { "title": "Youtube Video Cut and Download", "description": "Your all-in-one toolkit to instantly cut, download, and reformat YouTube videos. Trim specific clips, convert to a vertical 9:16 format for Shorts/TikTok, or extract high-quality audio in seconds.", "version": "0.0", "x-build-id": "uRRq3gjHecbJs0QqZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nodexagent~youtube-video-cut-and-download/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nodexagent-youtube-video-cut-and-download", "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/nodexagent~youtube-video-cut-and-download/runs": { "post": { "operationId": "runs-sync-nodexagent-youtube-video-cut-and-download", "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/nodexagent~youtube-video-cut-and-download/run-sync": { "post": { "operationId": "run-sync-nodexagent-youtube-video-cut-and-download", "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": [ "url" ], "properties": { "url": { "title": "YouTube Video URL", "type": "string", "description": "The full https://www.youtube.com/... URL of the video.", "default": "https://www.youtube.com/watch?v=aqz-KE-bpKQ" }, "trim": { "title": "Trim Video", "type": "boolean", "description": "Check this box to download only a specific part of the video.", "default": false }, "convertToVertical": { "title": "Convert to Vertical (9:16)", "type": "boolean", "description": "Check this to crop the video into a vertical format for Shorts/TikTok.", "default": false }, "startTime": { "title": "Start Time (HH:MM:SS)", "type": "string", "description": "Enter the start time for the clip, e.g., 00:01:30." }, "endTime": { "title": "End Time (HH:MM:SS)", "type": "string", "description": "Enter the end time for the clip, e.g., 00:02:00." }, "quality": { "title": "Video Quality", "enum": [ "best", "1080p", "720p", "480p", "worst" ], "type": "string", "description": "Select the desired video quality. 'best' will pick the highest available.", "default": "1080p" }, "format": { "title": "Video Format", "enum": [ "mp4", "mkv", "webm", "mov" ], "type": "string", "description": "Select the desired video container format.", "default": "mp4" }, "audioOnly": { "title": "Audio Only", "type": "boolean", "description": "Check this to download only the audio track.", "default": false }, "audioFormat": { "title": "Audio Format", "enum": [ "mp3", "wav", "m4a", "flac" ], "type": "string", "description": "Select the format for audio-only downloads.", "default": "mp3" }, "cookies": { "title": "YouTube Cookies", "type": "string", "description": "1. Install the 'Get cookies.txt LOCALLY' browser extension.\n2. Go to youtube.com and log in.\n3. Click the extension icon and 'Copy Cookies'.\n4. Paste the copied text here.\n5. cookies come with an expiration date, meaning they only work for a limited time." }, "proxyHost": { "title": "Proxy Host", "type": "string", "description": "Optional. The hostname or IP address of your proxy server (e.g. proxy.example.com)." }, "proxyPort": { "title": "Proxy Port", "type": "integer", "description": "Optional. The port number of your proxy server (e.g. 8080)." }, "proxyUsername": { "title": "Proxy Username", "type": "string", "description": "Optional. Username for proxy authentication." }, "proxyPassword": { "title": "Proxy Password", "type": "string", "description": "Optional. Password for proxy authentication." } } }, "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 } } } } } } } } } }