{ "openapi": "3.0.1", "info": { "title": "YouTube Video Frame Extractor", "description": "Extract JPEG frames from any YouTube video: at exact timestamps (to the millisecond), every N seconds, or N evenly spaced frames, at 360p-1080p. Downloads only the seconds around each frame, so even hour-long videos are fast. Pay per frame; failed frames are free.", "version": "1.0", "x-build-id": "0NnNQeA3nV1UJT6lf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ttechx~youtube-video-frame-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ttechx-youtube-video-frame-extractor", "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/ttechx~youtube-video-frame-extractor/runs": { "post": { "operationId": "runs-sync-ttechx-youtube-video-frame-extractor", "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/ttechx~youtube-video-frame-extractor/run-sync": { "post": { "operationId": "run-sync-ttechx-youtube-video-frame-extractor", "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": [ "videos" ], "properties": { "videos": { "title": "YouTube videos", "type": "array", "description": "Video URLs (watch, youtu.be, Shorts, embed or live links) or 11-character video ids, up to 500. Every timestamp below is captured from each video.", "items": { "type": "string" } }, "mode": { "title": "What to capture", "enum": [ "timestamps", "interval", "evenly" ], "type": "string", "description": "Exact timestamps you list, one frame every N seconds, or N frames spread evenly over the video. Interval and evenly spaced modes apply to each video's own length.", "default": "timestamps" }, "timestamps": { "title": "Timestamps (exact timestamps mode)", "type": "array", "description": "Times to capture, as HH:MM:SS or HH:MM:SS.mmm (1-3 fraction digits), e.g. 00:01:23 or 00:01:23.250. You get the frame on screen at that time. Up to 1000 per run; duplicates are dropped.", "items": { "type": "string" } }, "intervalSeconds": { "title": "Every N seconds (interval mode)", "minimum": 0.1, "type": "number", "description": "Seconds between frames, from 0.1 up. For example 10 gives frames at 0:00, 0:10, 0:20 and so on. At most 1000 frames per video.", "default": 10 }, "frameCount": { "title": "Number of frames (evenly spaced mode)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Frames per video. The range is split into equal parts and the frame in the middle of each part is taken, so you skip the black first frame and the very end.", "default": 10 }, "startTime": { "title": "Start time (optional)", "pattern": "^$|^\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{1,3})?$", "type": "string", "description": "Interval and evenly spaced modes only: start the range here, as HH:MM:SS[.mmm]. Default: the start of the video." }, "endTime": { "title": "End time (optional)", "pattern": "^$|^\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{1,3})?$", "type": "string", "description": "Interval and evenly spaced modes only: end the range here, as HH:MM:SS[.mmm]. Default: the end of the video." }, "resolution": { "title": "Resolution", "enum": [ "360", "480", "720", "1080" ], "type": "string", "description": "Frame height. A video smaller than this keeps its native size.", "default": "720" } } }, "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 } } } } } } } } } }