{
"openapi": "3.0.1",
"info": {
"title": "Video Frame Extractor",
"description": "Take still frames and thumbnails out of videos: evenly spread, one every few seconds, or at the times you name. Give MP4, WebM, MOV or other video links; get JPEG, PNG or WebP frames with links, times and sizes, plus each video's length and resolution.",
"version": "1.0",
"x-build-id": "KT8vxh85yt3laB60g"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/cyber1nj3ct0r~video-frame-extractor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-cyber1nj3ct0r-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/cyber1nj3ct0r~video-frame-extractor/runs": {
"post": {
"operationId": "runs-sync-cyber1nj3ct0r-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/cyber1nj3ct0r~video-frame-extractor/run-sync": {
"post": {
"operationId": "run-sync-cyber1nj3ct0r-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",
"properties": {
"videoUrls": {
"title": "Video addresses",
"type": "array",
"description": "Direct links to video files (MP4, WebM, MOV, MKV, AVI and most others ffmpeg reads), for example https://www.example.com/clip.mp4. Add them one by one, paste many with Bulk edit, or link a text file that lists them. Pages of video sites (YouTube, Instagram, TikTok) are not video files and do not work.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"mode": {
"title": "How to pick frames",
"enum": [
"count",
"interval",
"timestamps"
],
"type": "string",
"description": "Evenly spread takes the number of frames below across the whole video. Every few seconds takes one frame each interval from the start. At these times takes the frames at the times you list.",
"default": "count"
},
"frameCount": {
"title": "Number of frames",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "For Evenly spread: how many frames to take from each video.",
"default": 10
},
"intervalSecs": {
"title": "Every",
"minimum": 1,
"maximum": 3600,
"type": "integer",
"description": "For Every few seconds: the time between two frames.",
"default": 10
},
"timestamps": {
"title": "Times",
"type": "array",
"description": "For At these times: one time per line, in seconds (83.5) or as minutes and seconds (1:23, 1:02:03). Times past the end of a video are skipped.",
"items": {
"type": "string"
}
},
"format": {
"title": "Picture format",
"enum": [
"jpg",
"png",
"webp"
],
"type": "string",
"description": "JPEG files are small, PNG files keep every detail, WebP files are the smallest at the same look.",
"default": "jpg"
},
"width": {
"title": "Frame width",
"minimum": 16,
"maximum": 7680,
"type": "integer",
"description": "Make frames this many pixels wide; the height follows the video's shape. Leave empty to keep the video's own size. Frames are never made larger than the video."
},
"quality": {
"title": "Quality",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "For JPEG and WebP: higher gives a sharper picture and a larger file.",
"default": 85
},
"maxFramesPerVideo": {
"title": "Frames per video at most",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "No video gives more frames than this, whatever the choice above. Your spending limit for the run also stops it.",
"default": 100
},
"maxVideoSizeMb": {
"title": "Largest video",
"minimum": 1,
"maximum": 8000,
"type": "integer",
"description": "Videos larger than this are not downloaded. The run's disk space is twice its memory, and two videos are read at once: for videos above 1,000 MB, give the run more memory. 1 MB is 1,000,000 bytes.",
"default": 500
},
"requestTimeoutSecs": {
"title": "Time limit per download",
"minimum": 10,
"maximum": 1800,
"type": "integer",
"description": "How long downloading one video may take.",
"default": 300
},
"userAgent": {
"title": "User-Agent",
"type": "string",
"description": "The name the tool sends when it downloads a video. Leave empty to use the tool's own name, which tells site owners what is visiting. Set your own only for sites you run or have permission to use."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}