{ "openapi": "3.0.1", "info": { "title": "Universal Cloud Video Converter", "description": "Download and extract rich video metadata from Video Converter, supporting resolutions up to 4K. Scrapes titles, duration, channel information, view counts, likes, user comments, and subtitles. Built with complete proxy rotation and anti-bot bypass support.", "version": "1.0", "x-build-id": "2zSKpLHtT5rWtrsod" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codingfrontend~video-converter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codingfrontend-video-converter", "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/codingfrontend~video-converter/runs": { "post": { "operationId": "runs-sync-codingfrontend-video-converter", "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/codingfrontend~video-converter/run-sync": { "post": { "operationId": "run-sync-codingfrontend-video-converter", "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": [ "inputType", "outputFormat" ], "properties": { "inputType": { "title": "Input Type", "enum": [ "url", "dropbox", "googleDrive", "cloudStorage", "apifyStorage" ], "type": "string", "description": "Select where to get the input video from. Choose 'url' for direct video URLs, 'dropbox' for Dropbox shared links, 'googleDrive' for Google Drive files, 'cloudStorage' for S3/GCS buckets, or 'apifyStorage' for Apify Key-Value Store.", "default": "url" }, "videoUrl": { "title": "Video URL", "type": "string", "description": "Direct URL to the video file. Required when Input Type is 'url'. Supports HTTP/HTTPS URLs to MP4, MOV, AVI, MKV, WebM and other video formats." }, "urlAuthType": { "title": "URL Auth Type", "enum": [ "none", "bearer", "basic", "header" ], "type": "string", "description": "Authentication method for downloading video from protected URLs. Required only if the video URL needs authentication. Use 'bearer' for API tokens, 'basic' for username/password, or 'header' for custom headers.", "default": "none" }, "urlAuthBearerToken": { "title": "Bearer Token", "type": "string", "description": "Bearer token for URL authentication. Required when URL Auth Type is 'bearer'. The token will be sent as 'Authorization: Bearer {token}' header." }, "urlAuthUsername": { "title": "URL Auth Username", "type": "string", "description": "Username for HTTP Basic authentication. Required when URL Auth Type is 'basic'." }, "urlAuthPassword": { "title": "URL Auth Password", "type": "string", "description": "Password for HTTP Basic authentication. Required when URL Auth Type is 'basic'." }, "urlAuthHeaderName": { "title": "Custom Auth Header Name", "type": "string", "description": "Custom header name for authentication. Required when URL Auth Type is 'header'. Example: 'X-API-Key' or 'Authorization'." }, "urlAuthHeaderValue": { "title": "Custom Auth Header Value", "type": "string", "description": "Custom header value for authentication. Required when URL Auth Type is 'header'. This is the actual token/key value." }, "googleDriveFileId": { "title": "Google Drive File ID", "type": "string", "description": "Google Drive file ID. Required when Input Type is 'googleDrive'. Find it in the file URL: drive.google.com/file/d/{FILE_ID}/view" }, "googleDriveCredentials": { "title": "Google Drive Credentials", "type": "object", "description": "Google Drive API service account credentials. Required when Input Type is 'googleDrive'. Paste the entire JSON key file content from Google Cloud Console." }, "outputFormat": { "title": "Output Format", "enum": [ "mp4", "mov", "webm", "mkv", "avi", "gif", "hls" ], "type": "string", "description": "Select the desired output video format. 'mp4' is most compatible, 'webm' for web use, 'hls' for adaptive streaming, 'gif' for animated images.", "default": "hls" }, "videoCodec": { "title": "Video Codec", "enum": [ "h264", "h265", "vp8", "vp9", "av1", "copy" ], "type": "string", "description": "Video codec for encoding. 'h264' is most compatible, 'h265' for better compression, 'vp9' for WebM, 'copy' to keep original (fastest).", "default": "h264" }, "audioCodec": { "title": "Audio Codec", "enum": [ "aac", "mp3", "opus", "vorbis", "copy", "none" ], "type": "string", "description": "Audio codec for encoding. 'aac' is most compatible, 'mp3' for universal support, 'opus' for WebM, 'copy' to keep original, 'none' to remove audio.", "default": "aac" }, "quality": { "title": "Quality", "enum": [ "low", "medium", "high", "veryhigh" ], "type": "string", "description": "Output video quality preset. Higher quality = larger file size. 'low' (~500kbps), 'medium' (~1Mbps), 'high' (~2Mbps), 'veryhigh' (~4Mbps).", "default": "medium" }, "preset": { "title": "Encoding Preset", "enum": [ "ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow", "slower", "veryslow" ], "type": "string", "description": "Encoding speed vs compression tradeoff. 'ultrafast' is quickest but larger files, 'veryslow' is smallest files but takes longer. 'medium' is balanced.", "default": "medium" }, "resolution": { "title": "Resolution", "type": "string", "description": "Output video resolution. Leave empty to keep original. Format: WIDTHxHEIGHT. Common values: '1920x1080' (Full HD), '1280x720' (HD), '854x480' (SD)." }, "fps": { "title": "Frame Rate (FPS)", "minimum": 1, "maximum": 120, "type": "integer", "description": "Output video frame rate. Leave empty to keep original. Common values: 24 (cinema), 30 (web), 60 (gaming/smooth)." }, "bitrate": { "title": "Video Bitrate", "type": "string", "description": "Video bitrate override. Leave empty for automatic based on quality. Examples: '2M' (2 Mbps), '5000k' (5000 kbps)." }, "audioBitrate": { "title": "Audio Bitrate", "type": "string", "description": "Audio bitrate. Leave empty for automatic. Common values: '128k' (standard), '192k' (good), '320k' (high quality)." }, "extractorEnabled": { "title": "Enable Track Extractor", "type": "boolean", "description": "Enable to extract video, audio, and subtitle tracks into separate files instead of converting. When enabled, output format settings are ignored.", "default": false }, "extractorExtractVideo": { "title": "Extract Video Track", "type": "boolean", "description": "Extract video track without audio. Requires 'Enable Track Extractor' to be ON.", "default": true }, "extractorExtractAudio": { "title": "Extract Audio Track", "type": "boolean", "description": "Extract audio track as separate file. Requires 'Enable Track Extractor' to be ON. Output format controlled by 'Extractor Audio Format'.", "default": true }, "extractorExtractSubtitles": { "title": "Extract Subtitles", "type": "boolean", "description": "Extract subtitle/caption tracks if present. Requires 'Enable Track Extractor' to be ON. Not all videos have embedded subtitles.", "default": true }, "extractorVideoCodec": { "title": "Extractor Video Codec", "enum": [ "h264", "h265", "vp9", "copy" ], "type": "string", "description": "Video codec for extracted video track. Use 'copy' for fastest extraction without re-encoding.", "default": "copy" }, "extractorAudioFormat": { "title": "Extractor Audio Format", "enum": [ "mp3", "aac", "wav", "flac", "ogg", "opus" ], "type": "string", "description": "Output format for extracted audio. 'mp3' for universal compatibility, 'flac' for lossless, 'aac' for Apple devices.", "default": "mp3" }, "extractorAudioBitrate": { "title": "Extractor Audio Bitrate", "type": "string", "description": "Bitrate for extracted audio. Leave empty for automatic. Examples: '128k', '192k', '320k' for MP3." }, "extractorSubtitleFormat": { "title": "Extractor Subtitle Format", "enum": [ "srt", "ass", "vtt" ], "type": "string", "description": "Output format for extracted subtitles. 'srt' is most compatible, 'vtt' for web, 'ass' for styled subtitles.", "default": "srt" }, "trimStart": { "title": "Trim Start Time", "type": "string", "description": "Start time for trimming. Leave empty to start from beginning. Format: 'HH:MM:SS' or seconds. Examples: '00:01:30', '90'." }, "trimEnd": { "title": "Trim End Time", "type": "string", "description": "End time for trimming. Leave empty to go until end. Format: 'HH:MM:SS' or seconds. Examples: '00:05:00', '300'." }, "watermarkEnabled": { "title": "Enable Watermark", "type": "boolean", "description": "Enable to add a text or image watermark to the video. Configure type, text/image, and position below.", "default": false }, "watermarkType": { "title": "Watermark Type", "enum": [ "text", "image" ], "type": "string", "description": "Type of watermark. Required when 'Enable Watermark' is ON. 'text' for text overlay, 'image' for logo/image overlay.", "default": "text" }, "watermarkText": { "title": "Watermark Text", "type": "string", "description": "Text to display as watermark. Required when Watermark Type is 'text'. Example: '© My Company 2024'." }, "watermarkImageUrl": { "title": "Watermark Image URL", "type": "string", "description": "URL of watermark image (PNG with transparency recommended). Required when Watermark Type is 'image'." }, "watermarkPosition": { "title": "Watermark Position", "enum": [ "top-left", "top-right", "bottom-left", "bottom-right", "center" ], "type": "string", "description": "Position of the watermark on the video. Choose corner or center placement.", "default": "bottom-right" }, "watermarkFontSize": { "title": "Watermark Font Size", "minimum": 8, "maximum": 200, "type": "integer", "description": "Font size for text watermark. Only applies when Watermark Type is 'text'. Range: 8-200.", "default": 24 }, "watermarkFontColor": { "title": "Watermark Font Color", "type": "string", "description": "Font color for text watermark. Use color names ('white', 'red') or hex codes ('#FF0000'). Only applies when Watermark Type is 'text'.", "default": "white" }, "watermarkOpacity": { "title": "Watermark Opacity", "type": "string", "description": "Watermark transparency. '1.0' is fully opaque, '0.5' is semi-transparent, '0.0' is invisible. Recommended: 0.5-0.8.", "default": "0.8" }, "audioVolume": { "title": "Audio Volume", "type": "string", "description": "Adjust audio volume. '1.0' is original, '0.5' is half volume, '2.0' is double volume. Leave empty for no change." }, "audioNormalize": { "title": "Normalize Audio", "type": "boolean", "description": "Automatically adjust audio levels for consistent volume throughout the video.", "default": false }, "audioRemove": { "title": "Remove Audio", "type": "boolean", "description": "Remove audio track completely from output. Creates a silent video.", "default": false }, "audioReplaceUrl": { "title": "Replace Audio URL", "type": "string", "description": "URL of audio file to replace original audio. Supports MP3, AAC, WAV. Original audio will be removed." }, "thumbnailsEnabled": { "title": "Generate Thumbnails", "type": "boolean", "description": "Generate thumbnail images from the video at evenly spaced intervals.", "default": false }, "thumbnailsCount": { "title": "Thumbnail Count", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of thumbnails to generate. Requires 'Generate Thumbnails' to be ON. Range: 1-20.", "default": 1 }, "thumbnailsFormat": { "title": "Thumbnail Format", "enum": [ "jpg", "png", "webp" ], "type": "string", "description": "Image format for thumbnails. 'jpg' is smallest, 'png' for transparency, 'webp' for modern browsers.", "default": "jpg" }, "thumbnailsWidth": { "title": "Thumbnail Width", "minimum": 50, "maximum": 1920, "type": "integer", "description": "Width of thumbnails in pixels. Height is calculated automatically to maintain aspect ratio.", "default": 320 }, "gifPreviewEnabled": { "title": "Generate GIF Preview", "type": "boolean", "description": "Generate an animated GIF preview from a section of the video.", "default": false }, "gifPreviewStartTime": { "title": "GIF Start Time", "type": "string", "description": "Start time for GIF preview. Requires 'Generate GIF Preview' to be ON. Format: 'HH:MM:SS' or seconds.", "default": "0" }, "gifPreviewDuration": { "title": "GIF Duration", "minimum": 1, "maximum": 30, "type": "integer", "description": "Duration of GIF in seconds. Longer = larger file. Recommended: 3-10 seconds.", "default": 5 }, "gifPreviewWidth": { "title": "GIF Width", "minimum": 50, "maximum": 800, "type": "integer", "description": "Width of GIF in pixels. Smaller = smaller file size. Recommended: 200-400.", "default": 320 }, "gifPreviewFps": { "title": "GIF FPS", "minimum": 5, "maximum": 30, "type": "integer", "description": "Frames per second for GIF. Higher = smoother but larger file. Recommended: 10-15.", "default": 10 }, "outputDestination": { "title": "Output Destination", "enum": [ "apify", "s3", "gcs", "dropbox" ], "type": "string", "description": "Where to upload the converted video. 'apify' stores in Apify Key-Value Store (default), others require credentials configured below.", "default": "apify" }, "outputStoreKey": { "title": "Output Store Key", "type": "string", "description": "Key name for storing in Apify Key-Value Store. Only used when Output Destination is 'apify'. Include file extension.", "default": "converted_video.mp4" }, "s3Bucket": { "title": "S3 Bucket Name", "type": "string", "description": "AWS S3 bucket name. Required when Output Destination is 's3'. Example: 'my-video-bucket'." }, "s3Region": { "title": "S3 Region", "type": "string", "description": "AWS region where bucket is located. Required when Output Destination is 's3'. Example: 'us-east-1', 'eu-west-1'." }, "s3AccessKeyId": { "title": "S3 Access Key ID", "type": "string", "description": "AWS IAM access key ID. Required when Output Destination is 's3'. Get from AWS IAM Console." }, "s3SecretAccessKey": { "title": "S3 Secret Access Key", "type": "string", "description": "AWS IAM secret access key. Required when Output Destination is 's3'. Keep this secret!" }, "s3Path": { "title": "S3 Path/Key", "type": "string", "description": "Path/key in S3 bucket where file will be stored. Include filename. Example: 'videos/output.mp4'." }, "s3Acl": { "title": "S3 ACL", "enum": [ "private", "public-read" ], "type": "string", "description": "S3 access control. 'private' for restricted access, 'public-read' for public URL access.", "default": "private" }, "gcsBucket": { "title": "GCS Bucket Name", "type": "string", "description": "Google Cloud Storage bucket name. Required when Output Destination is 'gcs'." }, "gcsCredentials": { "title": "GCS Service Account Credentials", "type": "object", "description": "Google Cloud service account JSON credentials. Required when Output Destination is 'gcs'. Paste entire JSON key file." }, "gcsPath": { "title": "GCS Path", "type": "string", "description": "Path in GCS bucket where file will be stored. Required when Output Destination is 'gcs'. Example: 'videos/output.mp4'." }, "gcsMakePublic": { "title": "GCS Make Public", "type": "boolean", "description": "Make uploaded file publicly accessible via URL. Only applies when Output Destination is 'gcs'.", "default": false }, "dropboxAccessToken": { "title": "Dropbox Access Token", "type": "string", "description": "Dropbox API access token. Required when Output Destination is 'dropbox'. Get from Dropbox App Console." }, "dropboxPath": { "title": "Dropbox Path", "type": "string", "description": "Dropbox path where file will be saved. Required when Output Destination is 'dropbox'. Example: '/Videos/output.mp4'." }, "dropboxCreateSharedLink": { "title": "Create Dropbox Shared Link", "type": "boolean", "description": "Create a shareable link for the uploaded file. Only applies when Output Destination is 'dropbox'.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to receive notification when conversion completes. Optional. Will POST JSON with result data." }, "webhookSendFile": { "title": "Send Video File in Webhook", "type": "boolean", "description": "Send converted video file in webhook (multipart/form-data) instead of just URL. Requires webhook URL. May timeout for large files.", "default": false }, "webhookFileFieldName": { "title": "Webhook File Field Name", "type": "string", "description": "Form field name for the video file in webhook request. Only used when 'Send Video File in Webhook' is ON.", "default": "video" }, "webhookAuthHeader": { "title": "Webhook Auth Header", "type": "string", "description": "Authorization header value for webhook request. Optional. Example: 'Bearer your-secret-token' or 'Basic base64encoded'." } } }, "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 } } } } } } } } } }