{ "openapi": "3.0.1", "info": { "title": "YouTube Video Scraper", "description": "Scrape public YouTube channel videos for titles, views, publish dates, durations, thumbnails, hashtags, and optional descriptions and likes. Filter new uploads by topic, date, or views before billing. No login or YouTube API key required.", "version": "0.1", "x-build-id": "M01tkf2zgODarkBMp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/schnellscrapers~youtube-video-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-schnellscrapers-youtube-video-monitor", "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/schnellscrapers~youtube-video-monitor/runs": { "post": { "operationId": "runs-sync-schnellscrapers-youtube-video-monitor", "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/schnellscrapers~youtube-video-monitor/run-sync": { "post": { "operationId": "run-sync-schnellscrapers-youtube-video-monitor", "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": [ "channels" ], "properties": { "channels": { "title": "YouTube channels", "type": "array", "description": "One or more public channel handles, usernames, channel IDs, or channel URLs. Examples: `@Apify`, `Apify`, or `https://www.youtube.com/@Apify`.", "items": { "type": "string" } }, "maxVideosPerChannel": { "title": "Maximum videos per channel", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum videos considered from each channel before filters are applied. Lower values keep recurring monitoring runs fast and cheap.", "default": 50 }, "maxPagesPerChannel": { "title": "Maximum feed pages per channel", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum initial or continuation feed pages fetched per channel. One page is enough for a low-cost recurring check; increase it for older uploads.", "default": 1 }, "maxItems": { "title": "Maximum total videos", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Hard cap on videos written across all input channels after filters. Use a small value such as `20` for a cost-bounded smoke run.", "default": 1000 }, "sortBy": { "title": "Sort videos by", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "Order the channel feed as newest, popular, or oldest. Popular and oldest use YouTube's own channel sort controls when available.", "default": "newest" }, "publishedAfter": { "title": "Only videos published after", "type": "string", "description": "Optional exact date or relative period such as `2026-01-01`, `7 days`, or `2 weeks`. Date filtering fetches video detail pages for exact timestamps." }, "titleKeywords": { "title": "Include topic keywords", "type": "array", "description": "Keep a video when its title, description, or hashtags contain at least one of these case-insensitive phrases. Filtering happens before dataset writes.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop a video when its title, description, or hashtags contain any of these case-insensitive phrases. Filtering happens before dataset writes.", "items": { "type": "string" } }, "minViews": { "title": "Minimum views", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Keep only videos with at least this many parsed views. Videos without a view count are excluded when this is greater than zero.", "default": 0 }, "includeVideoDetails": { "title": "Fetch exact video details", "type": "boolean", "description": "Fetch each selected video page for exact publish time, views, likes, description, duration, and channel metadata. Off is the cheapest feed-only mode.", "default": false }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Fetch, filter, and validate videos without writing dataset records. Use for previews and smoke tests when you want logs without result billing.", "default": false } } }, "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 } } } } } } } } } }