{
"openapi": "3.0.1",
"info": {
"title": "YouTube Channel Scraper - Subscribers, Stats & Videos",
"description": "Scrape YouTube channels: subscribers, total views, video count, join date, country, description and links, plus each channel's latest or most popular videos, Shorts and live streams. Find channels by keyword. No API key, no extra fees.",
"version": "0.1",
"x-build-id": "YOnxIPKlynj4cUTma"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/dataspace~youtube-channel-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-dataspace-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/dataspace~youtube-channel-scraper/runs": {
"post": {
"operationId": "runs-sync-dataspace-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/dataspace~youtube-channel-scraper/run-sync": {
"post": {
"operationId": "run-sync-dataspace-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",
"properties": {
"channelUrls": {
"title": "Channels",
"type": "array",
"description": "YouTube channels, one per line: a handle (@MrBeast), a channel URL (https://www.youtube.com/@veritasium) or a channel ID (UCX6OQ3DkcsbYNE6H8uQQuVA).",
"items": {
"type": "string"
}
},
"searchKeywords": {
"title": "Find channels by keyword",
"type": "array",
"description": "Find channels with YouTube search (channels only), e.g. cooking, personal finance, react tutorial. Each channel found is scraped like the ones above.",
"items": {
"type": "string"
}
},
"maxChannelsPerKeyword": {
"title": "Max channels per keyword",
"minimum": 1,
"type": "integer",
"description": "How many channels to take from each keyword search.",
"default": 20
},
"maxVideosPerChannel": {
"title": "Videos per channel",
"minimum": 0,
"type": "integer",
"description": "How many regular videos to return from each channel. Set 0 to get channel info only.",
"default": 20
},
"maxShortsPerChannel": {
"title": "Shorts per channel",
"minimum": 0,
"type": "integer",
"description": "How many Shorts to return from each channel (0 = none).",
"default": 0
},
"maxStreamsPerChannel": {
"title": "Live streams per channel",
"minimum": 0,
"type": "integer",
"description": "How many live streams / past streams to return from each channel (0 = none).",
"default": 0
},
"sortVideosBy": {
"title": "Sort videos by",
"enum": [
"latest",
"popular",
"oldest"
],
"type": "string",
"description": "Same as the Latest / Popular / Oldest buttons on a channel page.",
"default": "latest"
},
"oldestPostDate": {
"title": "Only videos newer than",
"type": "string",
"description": "Skip videos published before this date: an exact date (2026-01-31) or a period (30 days, 6 months, 1 year). Works for videos and streams. With 'Latest' sorting the run stops as soon as older videos start, which saves time and money."
},
"includeVideoDetails": {
"title": "Add video details",
"type": "boolean",
"description": "Also get each video's like count, comment count, exact publish date, full description and hashtags. Slower (one extra request per video), same price per result.",
"default": false
},
"country": {
"title": "Country",
"type": "string",
"description": "Two-letter country code used for keyword search results, e.g. US, GB, DE.",
"default": "US"
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "The scraper connects directly first and switches to a new proxy IP only if YouTube slows it down. The default works for most runs.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}