// YouTube Data API 教學

YouTube Data API key 教學：5 分鐘取得，並掌握每日免費配額

想讓自動化工具替你取得 YouTube 的搜尋結果、影片資料或頻道數據，就要一條 YouTube Data API v3 的 key。這一頁由建立 Google Cloud project 開始，帶你啟用 API、建立 key、在 n8n 用 Query 認證掛上去，並說明「每日 10,000 配額」實際上夠用多少。完全免費，不需要信用卡。

甚麼是 YouTube Data API？跟直接爬網頁有甚麼分別？

YouTube Data API v3 是 Google 官方提供的資料介面，讓程式用結構化方式取得 YouTube 上的公開資料：搜尋結果、影片標題與描述、頻道資訊、播放清單等。

跟自己寫爬蟲抓取網頁比較，官方 API 的分別在於：

  • 穩定：傳回格式固定，YouTube 改版不會令你的流程一夜失效。
  • 合規：在配額內使用是官方允許的，不會有被封的風險。
  • 有配額：這是代價。每個 project 每日有固定配額，用完要等隔日重置。

要留意 API 只讀得到公開資料。它讀取不到別人頻道的觀看時長、收益這類私有數據，那些要頻道擁有者授權（另一套 Analytics API）。

取得 YouTube Data API key（逐步）

  1. 建立或選用一個 Google Cloud project：到 console.cloud.google.com，用你的 Google 帳戶登入，在頂部的 project 選單建立一個新 project（名字隨意，例如「automation」）。同一個 project 之後可以放其他 Google API。
  2. 啟用 YouTube Data API v3：進入 API Library，搜尋「YouTube Data API v3」，開啟該頁按 Enable（官方入門文件）。這一步最常被漏掉，若未啟用，呼叫會傳回 403 accessNotConfigured。
  3. 建立 API key：前往 Credentials → Create credentials → API key。建好後可以改名（例如 Testing），方便日後辨認。
  4. （建議）限制用途：在該條 key 的設定裏，把 API restrictions 設為只限 YouTube Data API v3。這樣萬一外露，別人也用不到你 project 的其他服務。注意：從伺服器呼叫時不要設 HTTP referrer 限制，否則會被阻擋。
  5. 在 n8n 掛上去：新增憑證時選 Query Auth：參數名（Name）填 key，值（Value）貼上你的 API key。YouTube Data API 是靠網址上的 query 參數認證，不是 Bearer token，選錯認證方式會傳回 400 keyInvalid。

配額觀念：每個 project 每日有配額（預設 10,000 單位），而且是按 project 計、不是按 key 計。搜尋操作最貴（一次 100 單位），讀取影片資料便宜得多。逐個操作的單位成本見 Google 的配額成本表。每天早上抓取幾個搜尋字詞的用量，離上限很遠。

安全提醒：API key 等同密碼，不要貼進公開的 GitHub、截圖或影片。錄影前先確認畫面沒有展開 key。

在 Google Cloud 搜尋並啟用 YouTube Data API v3

在 Google Cloud 搜尋 YouTube Data API v3 並啟用。漏了這步會傳回 403 accessNotConfigured。

Google Cloud Credentials 建立 API key 並限制用途

Credentials → Create credentials → API key，建議把用途限制為 YouTube Data API。

在 n8n 用 Query Auth 掛上 YouTube API key，參數名填 key

在 n8n 用 Query Auth 掛上去：參數名填 key，值貼上 API key（畫面上已遮蔽）。

常見疑難排解

  • 傳回 403 accessNotConfigured：最常見的情況：你建了 key，但忘記在該 project 啟用 YouTube Data API v3。返回 API Library 搜尋，按 Enable。啟用後可能要等一兩分鐘才生效。
  • 傳回 403 quotaExceeded：當日配額用完。留意搜尋（search.list）是最貴的操作，一次便消耗 100 單位；每日 10,000 的預設配額換算即大約 100 次搜尋。把搜尋字收窄、減少每日執行的次數即可。
  • 傳回 400 keyInvalid：key 輸入錯誤，或者放錯位置。YouTube Data API 用的是 query 參數 key，不是 Bearer token；如果在 n8n 選了 Header Auth 就會這樣。
  • key 設了限制但呼叫失敗：如果你在 Credentials 設了 API restrictions，確認已勾選 YouTube Data API v3。另外，若設了 HTTP referrer 限制，從伺服器（n8n）呼叫時會被阻擋，這種情況應該改用 IP 限制或先不設限制。
  • 搜尋結果不符預期：search.list 預設按相關度排序，不是按時間。想要最新的內容，記得指定按日期排序，並用 publishedAfter 收窄時間範圍。

常見問答

不用。YouTube Data API 的免費配額不需要綁定付款方式，建立 project 與 key 都是免費的。它跟 Google Cloud 其他要收費的服務不同，只要不超出每日配額就完全免費。

要看你做甚麼操作，因為各項操作的成本有別。搜尋（search.list）最貴，一次 100 單位；讀取影片或頻道資料便宜得多，通常一次 1 單位。以自動化每天早上抓取幾個搜尋字詞來說，一天用掉幾百單位，離上限很遠。

每日重置一次（按太平洋時間計）。用完就要等下一個週期，沒有即時解除的方法。如果經常觸及上限，先檢查是不是把搜尋執行得過於頻密。

用 Query Auth（查詢參數認證），參數名填 key，值貼上你的 API key。不要用 Header Auth 或 Bearer token，YouTube Data API 不支援那種做法。

可以建立多條，但要留意配額是按 project 計，不是按 key 計。同一個 project 內建三條 key，它們共用同一份每日配額。若需分開配額，就要開不同的 project。

不能。API key 只能讀公開資料。要讀某個頻道的觀看時長、收益這類私有數據，需要該頻道擁有者透過 OAuth 授權，屬於另一套流程。

下一步

拿到 key 之後，看看可以用它自動化甚麼：

  • 內容選題引擎：每天早上自動掃 YouTube 熱話與行業新聞，用 AI 挑出適合你的選題寫入 Notion。

同一條工作流還會用到另外兩個 API：OpenAI API key 設定（負責篩選與構思角度）與 Notion API 設定（負責存放選題）。三個都拿到，整條流程就能順利貫通。

Scroll to Top