{ "openapi": "3.0.1", "info": { "title": "YouTube Video Uploader - Auto-Publish From a URL", "description": "Upload a video to your own YouTube channel from a public file link, through the YouTube Data API and your own Google project. Sets title, description, tags, category, thumbnail and privacy, and can schedule the publish time. Returns the video ID, watch URL and stored privacy. $0.05 per upload.", "version": "0.1", "x-build-id": "hTpmLd59O3qCtQWfL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~youtube-video-uploader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-youtube-video-uploader", "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/dami_studio~youtube-video-uploader/runs": { "post": { "operationId": "runs-sync-dami_studio-youtube-video-uploader", "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/dami_studio~youtube-video-uploader/run-sync": { "post": { "operationId": "run-sync-dami_studio-youtube-video-uploader", "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", "properties": { "demoMode": { "title": "Preview only (no upload)", "type": "boolean", "description": "Writes one labelled sample row to the run's key-value store instead of uploading, so you can see the shape of the output. No credentials needed. The Actor also does this when no credentials are given at all.", "default": false }, "videoUrl": { "title": "Video URL", "type": "string", "description": "A public, direct link to the video file (.mp4 or .mov) that opens without a login. You host it, for example on a CDN, in cloud storage or in an Apify key-value store." }, "title": { "title": "Video title", "type": "string", "description": "The YouTube title, 100 characters at most." }, "description": { "title": "Description", "type": "string", "description": "The video description. Your hashtags are added at the end." }, "tags": { "title": "Tags", "type": "array", "description": "Up to 30 video tags.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Added to the end of the description as #tag, for example shorts or cooking.", "items": { "type": "string" } }, "privacyStatus": { "title": "Privacy", "enum": [ "public", "unlisted", "private" ], "type": "string", "description": "public, unlisted or private. A video with a publish time goes up as private, because YouTube schedules only private videos.", "default": "private" }, "thumbnailUrl": { "title": "Custom thumbnail URL", "type": "string", "description": "Optional public link to a thumbnail image. YouTube accepts custom thumbnails only on verified channels; if it refuses, the video is still uploaded and thumbnailSet says false." }, "madeForKids": { "title": "Made for kids", "type": "boolean", "description": "Declares the video as made for kids (COPPA). The declaration is yours.", "default": false }, "publishAt": { "title": "Publish at (schedule)", "type": "string", "description": "Optional future date and time for YouTube to publish the video, for example 2027-06-15T14:00:00Z. A date in the past or one YouTube cannot read stops the run before anything is downloaded." }, "categoryId": { "title": "Category ID", "type": "string", "description": "YouTube category number. 22 = People & Blogs, 24 = Entertainment, 23 = Comedy, 27 = Education.", "default": "22" }, "clientId": { "title": "Google OAuth client ID", "type": "string", "description": "From your own Google Cloud project: an OAuth client with the YouTube Data API v3 enabled. Kept secret." }, "clientSecret": { "title": "Google OAuth client secret", "type": "string", "description": "The secret of the same OAuth client. Kept secret." }, "refreshToken": { "title": "Google OAuth refresh token", "type": "string", "description": "A refresh token for your channel's Google account, created with the youtube.upload scope by the same OAuth client. Kept secret." } } }, "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 } } } } } } } } } }