{
  "openapi": "3.0.1",
  "info": {
    "title": "⚡ Fast YouTube Channel Scraper",
    "description": "Fast YouTube Channel Scraper: extract Videos, Shorts & Live from any channel URL or @handle — exact views, likes, comments, tags, category, transcripts, engagement rate & outlier score. No YouTube API key or quota. Bulk scrape into a clean Apify dataset.",
    "version": "1.0",
    "x-build-id": "sqKKrDFpqOAytHhbw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/citrine_venus~fast-youtube-channel-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-citrine_venus-fast-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/citrine_venus~fast-youtube-channel-scraper/runs": {
      "post": {
        "operationId": "runs-sync-citrine_venus-fast-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/citrine_venus~fast-youtube-channel-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-citrine_venus-fast-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": [
          "urls"
        ],
        "properties": {
          "urls": {
            "title": "🔗 Channel URLs",
            "type": "array",
            "description": "📺 YouTube channel links to scrape — full URLs only, e.g. `https://www.youtube.com/@handle`, `https://www.youtube.com/channel/UC...`, `/c/...` or `/user/...`. One per line, bulk input supported.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "🎬 Max videos per channel",
            "minimum": 0,
            "maximum": 500000,
            "type": "integer",
            "description": "📬 How many regular videos to collect from each channel's Videos tab. 0 = skip regular videos.",
            "default": 10
          },
          "maxResultsShorts": {
            "title": "📱 Max Shorts per channel",
            "minimum": 0,
            "maximum": 500000,
            "type": "integer",
            "description": "📱 How many Shorts to collect from each channel's Shorts tab. 0 = skip Shorts.",
            "default": 0
          },
          "maxResultStreams": {
            "title": "🔴 Max streams per channel",
            "minimum": 0,
            "maximum": 500000,
            "type": "integer",
            "description": "🔴 How many live/upcoming/ended streams to collect from each channel's Live tab. 0 = skip streams.",
            "default": 0
          },
          "sortVideosBy": {
            "title": "🔃 Sort order",
            "enum": [
              "NEWEST",
              "POPULAR",
              "OLDEST"
            ],
            "type": "string",
            "description": "🔃 Which order to read each tab in. Validated live against that channel's own sort options.",
            "default": "NEWEST"
          },
          "oldestPostDate": {
            "title": "📅 Only videos published after",
            "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$",
            "type": "string",
            "description": "📅 Stop collecting once videos get older than this. Use `YYYY-MM-DD` or a relative value like `30 days`. Leave blank to disable. Automatically forces sort order to Newest.",
            "default": ""
          },
          "enrichVideos": {
            "title": "🔍 Deep video enrichment",
            "type": "boolean",
            "description": "🔍 Fetch each video's own page for exact view/like counts, full description, tags, category and publish date. Required for comments, transcript and sponsor detection below.",
            "default": true
          },
          "includeAboutInfo": {
            "title": "📺 Channel About panel",
            "type": "boolean",
            "description": "📺 Also read the channel's About panel — description, country, joined date, exact subscriber/view/video totals and external links.",
            "default": true
          },
          "detectSponsors": {
            "title": "💰 Sponsor & affiliate detection",
            "type": "boolean",
            "description": "💰 Flag videos whose description contains sponsor phrasing or affiliate/tracking links (a lead to verify, not a certainty). Requires deep enrichment.",
            "default": true
          },
          "includeComments": {
            "title": "💬 Collect top comments",
            "type": "boolean",
            "description": "💬 Collect each video's top comments — author, text, likes, replies, pinned flag.",
            "default": false
          },
          "maxComments": {
            "title": "🔢 Max comments per video",
            "minimum": 0,
            "maximum": 200000,
            "type": "integer",
            "description": "🔢 Stop collecting comments for a video after this many.",
            "default": 5
          },
          "includeTranscript": {
            "title": "📝 Collect transcript",
            "type": "boolean",
            "description": "📝 Collect the video's caption track when one is available.",
            "default": false
          },
          "transcriptFormat": {
            "title": "📄 Transcript format",
            "enum": [
              "text",
              "timestamped",
              "srt",
              "segments"
            ],
            "type": "string",
            "description": "📄 File format for the collected transcript text.",
            "default": "text"
          },
          "monitorMode": {
            "title": "🔁 Stop at a known video",
            "type": "boolean",
            "description": "🔁 Forces sort order to Newest and stops each channel's listing as soon as \"Stop at this video ID\" is reached — only videos newer than it are returned.",
            "default": false
          },
          "sinceVideoId": {
            "title": "🆔 Stop at this video ID",
            "type": "string",
            "description": "🆔 The 11-character video ID (from a previous run) to stop at when Monitor mode is on. Leave blank to just collect the newest videos every run.",
            "default": ""
          },
          "webhookUrl": {
            "title": "📡 Notify a webhook with new videos",
            "type": "string",
            "description": "📡 When Monitor mode finds new videos for a channel, POST `{channel, newVideos}` once to this URL. Leave blank to disable.",
            "default": ""
          },
          "proxyConfiguration": {
            "title": "🌐 Proxy configuration",
            "type": "object",
            "description": "🚦 By default every run starts on a direct connection with no proxy and automatically escalates to a datacenter, then a residential proxy only if YouTube pushes back. Pick your own route here to override that.",
            "default": {
              "useApifyProxy": false
            }
          },
          "cookie": {
            "title": "🍪 Custom cookie header (optional)",
            "type": "string",
            "description": "🍪 Advanced: a raw `Cookie` header value, used to unlock age/consent-gated channels. Stored encrypted."
          },
          "outputFormat": {
            "title": "📦 Aggregate output shape",
            "enum": [
              "nested",
              "flat"
            ],
            "type": "string",
            "description": "📦 Shape of the extra full-run JSON saved to the key-value store's `OUTPUT` record (the live dataset table itself is always one flat row per video). `nested` = one object per channel with a `videos` array; `flat` = same flat rows as the dataset.",
            "default": "nested"
          },
          "maxConcurrency": {
            "title": "⚡ Videos in parallel",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "🏎️ How many videos to enrich at the same time, per channel.",
            "default": 5
          },
          "maxRetries": {
            "title": "🔁 Retries per request",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "🛡️ Attempts before a single request is considered failed on the current network route.",
            "default": 3
          },
          "maxScrollRetries": {
            "title": "♻️ Empty-page tolerance",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "♻️ Consecutive listing pages with no new videos allowed before a channel's tab is considered exhausted.",
            "default": 3
          },
          "maxScanned": {
            "title": "🧮 Max rows scanned per tab",
            "minimum": 100,
            "maximum": 200000,
            "type": "integer",
            "description": "🧮 Safety cap on how many listing rows are examined per tab before giving up — mainly relevant with a date cutoff on a very large channel.",
            "default": 20000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}