{ "openapi": "3.0.1", "info": { "title": "Youtube Most Replayed Scraper With Full Video Metadata & Tags", "description": "Extract the most replayed moments from any video with the YouTube Most Replayed Scraper. Get timestamps, replay intensity data, and engagement insights. Ideal for content optimization, highlight detection, and viewer behavior analysis. Fast, accurate, and easy to automate.", "version": "1.0", "x-build-id": "ojFk40Qs6j7h7j2yX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~youtube-most-replayed-actor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-youtube-most-replayed-actor", "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/scrapier~youtube-most-replayed-actor/runs": { "post": { "operationId": "runs-sync-scrapier-youtube-most-replayed-actor", "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/scrapier~youtube-most-replayed-actor/run-sync": { "post": { "operationId": "run-sync-scrapier-youtube-most-replayed-actor", "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": "🎬 YouTube watch URLs", "type": "array", "description": "πŸ”— Paste the videos you want the tag list, metadata block and replay peaks for. Example: `https://www.youtube.com/watch?v=dQw4w9WgXcQ`.", "items": { "type": "string" } }, "urls": { "title": "🧩 URLs β€” compatibility key", "type": "array", "description": "♻️ The original `urls` key, kept working so existing input JSON and scheduled tasks keep running unchanged. Anything you put here is scraped too. If you already filled the field above, leave this one alone.", "default": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ], "items": { "type": "string" } }, "includeDescription": { "title": "πŸ“ Include the full description text", "type": "boolean", "description": "πŸ“„ Emits `descriptionFull` (the complete description, not a snippet) and `descriptionLength`. Turn OFF for a much smaller dataset when you only need tags and counts.", "default": true }, "tagKeywords": { "title": "🏷️ Keep only videos tagged with…", "type": "array", "description": "πŸ” Case-insensitive substring match against the creator's own `keywords` list. A video is kept if ANY of its tags contains ANY of these words. Leave empty to keep everything. Non-matching videos are never charged.", "items": { "type": "string" } }, "skipVideosWithoutHeatmap": { "title": "πŸ”₯ Skip videos with no replay heatmap", "type": "boolean", "description": "πŸ“‰ About a third of videos have no published heatmap at all β€” mostly recent uploads. Switch this ON to keep only videos that actually have replay peaks.", "default": false }, "minLengthSeconds": { "title": "⏱️ Minimum video length (seconds)", "minimum": 0, "type": "integer", "description": "⬆️ Drop anything shorter. Useful to exclude Shorts, where a peak window covers most of the clip. Leave empty for no minimum." }, "maxLengthSeconds": { "title": "⏳ Maximum video length (seconds)", "minimum": 0, "type": "integer", "description": "⬇️ Drop anything longer, e.g. multi-hour streams. Leave empty for no maximum." }, "proxy": { "title": "πŸ›°οΈ Proxy routing", "type": "object", "description": "⚑ Runs with no proxy by default. A shared datacenter IP typically serves only the first watch page before YouTube answers \"Sign in to confirm you're not a bot\" β€” the actor detects that and switches itself to Apify Residential for the rest of the run. For runs of more than a couple of videos, selecting Residential here from the start is faster.", "default": {} }, "requestTimeoutSecs": { "title": "⏲️ Request timeout (seconds)", "minimum": 5, "maximum": 180, "type": "integer", "description": "πŸ•’ How long to wait for a watch page before treating it as failed.", "default": 20 }, "maxRetries": { "title": "πŸ” Retries per video", "minimum": 0, "maximum": 10, "type": "integer", "description": "♻️ Extra attempts after the first one fails. Videos that are genuinely unavailable are not retried β€” they return a typed, uncharged accounting row instead.", "default": 3 } } }, "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 } } } } } } } } } }