{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper", "description": "This YouTube channel scraper gets public channel profiles and channel videos, or finds channels and videos by keyword. Rows include subscriber counts, views, publish dates, thumbnails, and links when YouTube shows them. No YouTube login or API key is needed.", "version": "1.0", "x-build-id": "EsbRht6bQnEuKjthj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-youtube-channel-scraper", "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/maximedupre~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-youtube-channel-scraper", "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/maximedupre~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-youtube-channel-scraper", "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": [ "mode" ], "properties": { "mode": { "title": "Result type", "enum": [ "channelVideos", "channelProfiles", "keywordVideos", "keywordChannelProfiles" ], "type": "string", "description": "Choose the rows to save. Channel choices read the YouTube channels you list. Keyword choices search YouTube for the keywords you list. Only the list that matches your choice is used. The channel video options below apply only to Channel videos with profile data." }, "maxVideosPerChannel": { "title": "Video limit per channel", "minimum": 1, "type": "integer", "description": "Optional. The most videos to save from each channel. Leave empty to save every available video until the channel runs out of videos. Lower this for a quick, low-cost test." }, "sortBy": { "title": "Sort videos by", "enum": [ "latest", "popular", "oldest" ], "type": "string", "description": "Order to use from the YouTube channel Videos tab.", "default": "latest" }, "publishedAfter": { "title": "Published after", "pattern": "^$|^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Optional. Save only videos published on or after this UTC date, in YYYY-MM-DD format. The date check uses each video's exact UTC publish date. Reading those dates takes extra requests, so a date limit on a long channel makes the run slower." }, "publishedBefore": { "title": "Published before", "pattern": "^$|^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Optional. Save only videos published on or before this UTC date, in YYYY-MM-DD format. The date check uses each video's exact UTC publish date. Reading those dates takes extra requests, so a date limit on a long channel makes the run slower." }, "channels": { "title": "YouTube channels", "minItems": 1, "maxItems": 500, "type": "array", "description": "Used when Result type is Channel videos with profile data or Channel profiles only. Paste full YouTube channel links, @handles, channel IDs that start with UC, or plain handles. You can mix these formats in one run.", "items": { "type": "string", "minLength": 1 } }, "keywords": { "title": "Keywords", "minItems": 1, "maxItems": 500, "type": "array", "description": "Used when Result type is Videos from keyword search or Channel profiles from keyword search. Add each keyword or phrase as its own entry.", "items": { "type": "string", "minLength": 1 } }, "maxTotalRows": { "title": "Total row limit", "minimum": 1, "type": "integer", "description": "Optional. The most rows to save in one run. Leave empty to save every available row until the sources run out." }, "includeDescriptionLinks": { "title": "Include description links", "type": "boolean", "description": "Used when Result type is Channel videos with profile data, Channel profiles only, or Channel profiles from keyword search. Save the links from each channel's About section when available. This adds a small extra charge.", "default": false }, "includeEngagementAndTranscripts": { "title": "Include likes, comment counts, and transcripts", "type": "boolean", "description": "Optional. Used when Result type is Channel videos with profile data or Videos from keyword search. Adds each video's like count, comment count, and transcript text and language when captions exist. Each video needs extra YouTube requests, so runs take longer. Leave it off for faster runs.", "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 }, "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 } } } } } } } } } }