{ "openapi": "3.0.1", "info": { "title": "Video Frame Extractor: Scenes, Thumbnails | $1.50 per 1,000", "description": "Extract still frames from video files as JPEG, PNG or WebP images with timecodes: one every N seconds, a number evenly spaced, exact times, one per scene or every keyframe, plus a contact sheet. Paste MP4, MOV, WEBM, MKV or other video links; long files are read only around the frames asked for.", "version": "0.1", "x-build-id": "KveB6Ieo2LJEfBZCn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/v0iddo~video-frame-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-v0iddo-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/v0iddo~video-frame-extractor/runs": { "post": { "operationId": "runs-sync-v0iddo-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/v0iddo~video-frame-extractor/run-sync": { "post": { "operationId": "run-sync-v0iddo-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": [ "videoUrls" ], "properties": { "videoUrls": { "title": "Video links", "type": "array", "description": "Direct links to video files: MP4, MOV, M4V, WEBM, MKV, AVI, FLV, MPEG TS, OGV, WMV, MXF or animated GIF. Links to web pages (a YouTube or Vimeo page) are not files and are refused, and streaming playlists (M3U8, MPD) are not read.", "items": { "type": "string" } }, "mode": { "title": "Which frames", "enum": [ "interval", "count", "timestamps", "scenes", "keyframes" ], "type": "string", "description": "Every N seconds (Seconds between frames), a number of frames spread evenly over the video (Number of frames), the times you list (Times), the first frame of each scene, or every keyframe of the video.", "default": "count" }, "intervalSeconds": { "title": "Seconds between frames", "minimum": 1, "maximum": 3600, "type": "integer", "description": "For One frame every N seconds: the first frame is at Start at second.", "default": 10 }, "frameCount": { "title": "Number of frames", "minimum": 1, "maximum": 2000, "type": "integer", "description": "For evenly spaced frames: each frame sits in the middle of its equal part of the video, so the first and last are not the black start and end.", "default": 10 }, "timestamps": { "title": "Times", "type": "array", "description": "For Frames at exact times: seconds or hours:minutes:seconds, such as 90, 1:30 or 00:01:30.5.", "items": { "type": "string" } }, "sceneSensitivity": { "title": "Scene sensitivity", "enum": [ "low", "medium", "high" ], "type": "string", "description": "For One frame per scene: how much the picture must change to count as a new scene.", "default": "medium" }, "startSeconds": { "title": "Start at second", "minimum": 0, "maximum": 172800, "type": "integer", "description": "Skip the part of each video before this second.", "default": 0 }, "endSeconds": { "title": "End at second", "minimum": 0, "maximum": 172800, "type": "integer", "description": "Stop at this second of each video; 0 reads to the end.", "default": 0 }, "maxFramesPerVideo": { "title": "Maximum frames per video", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Caps the frames of one video in every mode.", "default": 100 }, "maxWidth": { "title": "Maximum width (px)", "minimum": 0, "maximum": 7680, "type": "integer", "description": "Wider frames are scaled down to this width, keeping their shape; 0 keeps the size of the video.", "default": 1280 }, "imageFormat": { "title": "Image format", "enum": [ "jpeg", "png", "webp" ], "type": "string", "description": "File type of the frame images.", "default": "jpeg" }, "imageQuality": { "title": "Image quality", "minimum": 1, "maximum": 100, "type": "integer", "description": "JPEG and WebP quality from 1 to 100; PNG is always lossless.", "default": 85 }, "contactSheet": { "title": "Contact sheet", "type": "boolean", "description": "Add one image per video that shows its frames side by side with their times (up to 100 frames). It is not charged.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 20000, "type": "integer", "description": "The run stops after this many result rows. It also caps what one run can cost.", "default": 500 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave as is: the run starts on the cheapest network the site accepts and switches to Apify Proxy automatically when the site blocks it. Pick proxy groups here only to force one specific network." } } }, "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 } } } } } } } } } }