Taboola API 指南：後台端點、驗證與實際應用

Taboola API——正式名稱為 Backstage API——是 Taboola 為廣告主提供的 REST 介面。您使用 OAuth 2.0 客戶端憑證進行驗證，然後讀寫您在廣告控制台（Ads Console）中能觸及的一切：廣告活動、創意素材項目、受眾設定、預算與成效報告，所有操作皆位於 https://backstage.taboola.com/backstage/api/1.0/{account_id}/… 路徑下。這是媒體買家用來自動化出價與預算調整、批次上傳創意素材、將花費同步至資料倉儲，以及建構 Taboola 使用者介面未提供的規則引擎的底層。它刻意不公開任何其他人的資料——要獲得網路的競爭視角，您需要一個完全不同的 API，我們將在文末說明。

Backstage API 涵蓋範圍#

Backstage 幾乎與廣告主控制台一一對應。實務上，四個領域承擔了大部分工作：

• 廣告活動管理。 建立、讀取、更新與暫停廣告活動；設定 CPC、每日與總預算、地區/平台受眾設定，以及網站封鎖。任何您會在早上七點檢查過夜數據後手動調整的事項，都可以改用腳本執行。
• 項目（創意素材）。 每個廣告活動包含項目——實際投放的圖片加標題單元。API 讓您能批次新增項目、更新其狀態，以及讀取每個項目的審核狀態，這是大型帳戶無需觸碰使用者介面即可部署數十種創意變體的方式。（如果您仍在手動設定第一批廣告活動，請先從我們的 Taboola 廣告活動設定逐步教學 開始——API 假設您已熟悉控制台的概念。）
• 報告。 按維度（日期、廣告活動、網站、國家、平台、項目）切分的彙總成效端點——任何自動化優化的原始材料。
• 字典。 供其他一切依賴的枚舉值查詢端點：國家代碼、平台、受眾區隔。

存取權限以客戶端 ID 與密鑰的形式提供——傳統上需透過您的 Taboola 客戶經理申請——而 官方 Backstage 參考文件 是當前端點結構與存取程序的權威來源。下文中的端點路徑截至撰寫本文時為最新；建構前請對照參考文件進行驗證。

驗證：從客戶端憑證到承載令牌#

Backstage 使用標準的 OAuth 2.0 客戶端憑證流程。將您的 ID 與密鑰交換為令牌：

curl -X POST "https://backstage.taboola.com/backstage/oauth/token" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials"

回應中包含一個 access_token，您需在每次呼叫時將其作為承載標頭發送：

curl "https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN"

該 allowed-accounts 呼叫是正確的第一步請求：它回傳每個其他端點在其路徑中需要的 account_id 值（數字 ID 與可讀名稱）。令牌會過期——快取一個令牌並在收到 401 錯誤時刷新，而非每次請求都生成新令牌，這既是為了降低延遲，也因為令牌請求的速率限制比資料請求更為嚴格。

您實際會用到的端點#

報告端點接受 start_date 與 end_date 查詢參數以及可選的篩選條件，而 dimension 區段（day、campaign_breakdown、site_breakdown、country_breakdown、platform_breakdown…）決定了切片維度。site_breakdown 是對優化最重要的端點：它是驅動封鎖清單自動化的每個發布商成效資料流。

媒體買家實際自動化的項目#

API 在四項重複性工作中賺回其設定成本：

1. 規則引擎。 經典應用：每小時拉取活躍廣告活動的 site_breakdown；任何花費超過目標 CPA N 倍且零轉換的網站，將透過廣告活動更新被加入該廣告活動的封鎖網站清單。這是每位認真的 Taboola 廣告主 手動執行的相同「砍掉虧損」循環——被編碼化、不帶情感，並在凌晨三點運行。
2. 出價管理。 在日期與地區表現優於目標時微幅調高廣告活動 CPC（以及可用的每個網站出價調整值），在 CPA 偏離時調低——微小、頻繁、枯燥但能產生複利效應的調整。
3. 批次創意素材操作。 為每個廣告活動上傳 30 個標題/圖片變體，每週暫停低於中位數 CTR 的所有素材，並在不需點擊一下午的情況下保持創意素材輪播領先於疲勞。
4. 花費資料管道。 每晚將按日彙總的 campaign-summary 拉取至資料倉儲，讓 Taboola 花費與轉換收益及其他所有渠道一同呈現在單一儀表板中。

最小可行整合計畫#

如果您從零開始，以下順序能讓您在大約一天的工作中達到有用的自動化，每個步驟在進入下一步前都可驗證：

1. 令牌往返。 將憑證交換為令牌並呼叫 allowed-accounts。如果成功，驗證與權限問題即告解決。
2. 唯讀報告。 拉取過去一週按日彙總的 campaign-summary，並將數字與廣告控制台對帳。在您的讀取資料與使用者介面顯示內容相符前，不要寫入任何資料。
3. 單一安全變更。 透過 PUT 暫停並恢復一個測試廣告活動。確認變更出現在控制台中，且投放狀態隨之改變。
4. 每晚花費同步。 將報告拉取排程至您的資料庫。僅此一項就足以為大多數團隊證明整合的價值。
5. 規則引擎，以模擬模式運行。 計算網站封鎖決策，並在讓它實際寫入前，記錄一週內「將會」發生的動作。將其選擇與您手動做出的決策進行比較，是您能執行最便宜的品質保證。

直接跳到第五步是常見錯誤——針對即時廣告帳戶的寫入路徑錯誤是代價高昂的教訓。

速率限制與實務注意事項#

• 尊重上限。 Backstage 實施每個帳戶的速率限制；批次讀取（每小時每個廣告活動一次報告呼叫，而非每分鐘一次）並在收到 429 回應時退避。請查閱參考文件以獲取當前限制，而非自行假設。
• 報告落後於投放。 最近幾小時的資料會隨時間穩定；基於至少數小時前的資料建構規則，否則您可能會因不完整的數字而暫停廣告活動。
• 編輯並非即時生效。 廣告活動變更傳播至投放會有延遲，且項目編輯可能重新觸發審核。自動化應容忍此間隙，而非重新發送「失敗」的寫入。
• 儲存 ID，而非名稱。 廣告活動與項目名稱會被人類編輯；數字 ID 是穩定的聯結鍵。
• 保護寫入路徑。 有錯誤的規則引擎可能暫停帳戶的全部花費或將出價提高 10 倍。記錄每次變更、增加合理性邊界（每次執行絕不更動出價超過 X%），並以模擬模式啟動任何新規則。

另一個 Taboola API：競爭情報資料#

以上所有內容僅檢視一個帳戶：您自己的。Backstage 永遠不會告訴您哪些廣告主在您的垂直領域擴張、他們正在投放什麼創意素材，或競爭對手的廣告活動存活了多久——該網路本身不發布廣告庫，也沒有官方端點會公開其他廣告主的活動。

這正是 OpenAdLibrary 開發者 API 所填補的缺口。該索引在涵蓋 49 個網路的 725,000+ 原生廣告語料庫中，保存了 206,000+ 個即時 Taboola 創意素材（2026年7月），而 Taboola 廣告庫 背後相同的資料可透過 REST 查詢：按廣告主、垂直領域、地區與存活時間搜尋創意素材；拉取標題與到達頁面；追蹤競爭對手何時啟動與終止廣告活動。原生廣告資料 API 指南 記錄了這些端點，如果您的 workflow 位於 LLM 代理程式中，還有一個 MCP 伺服器 可將相同語料庫作為工具提供給 Claude 與 ChatGPT。免費金鑰涵蓋輕度使用，且 定價 其餘部分保持不變；程式化廣告情報存取的更廣泛格局在 帶有 API 的廣告間諜工具 中有所探討。

這兩個 API 自然互補：Backstage 自動化您帳戶的執行，情報 API 自動化對其他人帳戶的研究。從自動化中獲得最大效益的買家同時運行兩者——一個規則引擎保持他們自己的廣告活動精簡，一個競爭情報資料流在垂直領域有新廣告主開始擴張時發出警報，讓下一個測試永遠不會盲目選擇。請先從 Taboola 間諜工具 開始，在瀏覽器中查看競爭語料庫，然後在 workflow 驗證可行時，將相同查詢轉為程式化操作。