{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper – Stats, Links, Emails & Channel Search", "description": "Get complete YouTube channel data: subscribers, exact total views and video count, join date, country, links, social profiles, emails and recent activity (last upload, median views). Find channels by keyword and filter by subscribers, country and activity. Optional videos and Shorts.", "version": "1.0", "x-build-id": "wr9n4RAaJrMIn1oUs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brii3343~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brii3343-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/brii3343~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-brii3343-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/brii3343~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-brii3343-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": { "channels": { "title": "Channels", "type": "array", "description": "One per line: @handle, channel ID (UC…), channel link (/@handle, /channel/UC…, /c/…, /user/…) or a video link (you get the channel that published it).", "items": { "type": "string" } }, "searchQueries": { "title": "Find channels by keyword", "type": "array", "description": "One search per line, as in the YouTube search bar with the “Channels” filter. Combine with the filters below to build lists of creators (for example: home workout, 10K–500K subscribers, United States, active in the last 30 days).", "items": { "type": "string" } }, "maxChannelsPerSearch": { "title": "Max channels per search", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Channels returned for each search term (after the filters). YouTube lists a few hundred channels per search at most.", "default": 50 }, "minSubscribers": { "title": "Min subscribers", "minimum": 0, "type": "integer", "description": "Only channels with at least this many subscribers (as shown by YouTube, e.g. 12.5K = 12,500)." }, "maxSubscribers": { "title": "Max subscribers", "minimum": 0, "type": "integer", "description": "Only channels with at most this many subscribers. Useful for finding micro-influencers." }, "channelCountries": { "title": "Channel countries", "type": "array", "description": "Only channels whose country (set by the creator in the channel's About section) is one of these. English names (Germany) or 2-letter codes (DE). Channels without a country are skipped.", "items": { "type": "string" } }, "activeWithinDays": { "title": "Active within (days)", "minimum": 1, "type": "integer", "description": "Only channels that uploaded a video, Short or stream in the last N days." }, "onlyWithEmail": { "title": "Only channels with an email in the description", "type": "boolean", "description": "Only channels that write an email address in their public description. (The business email that YouTube shows only after signing in is not collected; the field hasBusinessEmail tells you if a channel has one.)", "default": false }, "maxVideos": { "title": "Videos per channel", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Latest (or most popular / oldest) long-form videos to get for each channel. 0 = channel data only.", "default": 0 }, "maxShorts": { "title": "Shorts per channel", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Shorts to get for each channel.", "default": 0 }, "maxStreams": { "title": "Live streams per channel", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Past and current live streams to get for each channel.", "default": 0 }, "videosSort": { "title": "Sort videos by", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "Order of the channel's tabs on YouTube (Latest, Popular, Oldest).", "default": "newest" }, "videosNewerThan": { "title": "Only videos newer than", "type": "string", "description": "A date (2026-09-01) or an age (7 days, 2 weeks, 3 months). With “Newest first” the Actor stops at the first older video." }, "includeLatestUploads": { "title": "Include the latest 15 uploads in the channel row", "type": "boolean", "description": "Adds latestUploads to each channel row: ID, title, type, exact publish time, views and likes of the channel's 15 most recent uploads (free, no extra charge).", "default": false }, "country": { "title": "Search country", "type": "string", "description": "2-letter country code used for keyword searches (YouTube ranks channels by region). Results are always read in English.", "default": "US" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many channels or videos are read at the same time.", "default": 10 } } }, "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 } } } } } } } } } }