廣告檔案庫 API 誰用得到：只回傳政治廣告與投歐盟的廣告，台灣的商業廣告不在裡面

看完廣告檔案庫怎麼用之後想自動化的人，先看這一頁再動手。對本站多數讀者來說，結論是：API 給不了你要的東西。 下面講清楚它到底給什麼。

一、只有兩種廣告，沒有第三種

Meta 官方對這支 API 的描述（2026-09-13 查證）是：用來分析「社會議題、選舉或政治廣告，以及投放到歐盟及相關地區的廣告」。這句話就是一張清單，只有兩項：

廣告	在 API 裡嗎	為什麼
社會議題、選舉或政治類，任何國家	有，保留 7 年	Meta 2018 年起的政治廣告透明承諾
有投放到歐盟（與英國）的任何廣告	有，最後曝光後約 12 個月	歐盟數位服務法的廣告資料庫規定
只投台灣、美國、東南亞的一般商業廣告	沒有	沒有法規要求，Meta 就不開
品牌內容（創作者合作貼文）	授權使用者有	另一套品牌內容透明機制

對買帳號投台灣或美國市場的廣告主，第三列就是全部。用 ad_type=ALL 查一個台灣零售品牌會得到空清單，沒有任何參數能改變這件事。網頁版看得到那些廣告，API 看不到。

二、申請流程與 ads_archive 端點

三步，每步一到兩天：身分確認（政府證件，部分國家要郵寄驗證碼）、在 developers.facebook.com 建應用程式、產生存取權杖。之後所有查詢都打同一個端點：

GET https://graph.facebook.com/v21.0/ads_archive
  ?search_terms=<關鍵字>          （或 search_page_ids=<專頁ID>）
  &ad_reached_countries=['TW']    （必填，ISO-2 國碼陣列）
  &ad_type=POLITICAL_AND_ISSUE_ADS（或 ALL，但 ALL 只對歐盟／英國國碼有結果）
  &fields=id,page_name,ad_creative_bodies,ad_delivery_start_time,publisher_platforms,ad_snapshot_url
  &access_token=<權杖>

身分確認是多數人卡住的地方，而且跳不過。我們 2026 年替一個客戶的歐盟投放做監控時，證件審 3 天、地址驗證碼又等了 8 天，應用程式跟權杖只花 20 分鐘。第一次成功呼叫之前，抓兩週。

文件沒強調的三件事：ad_reached_countries 是開關，填 TW 只回政治廣告、填歐盟國家才回全部，沒有「所有國家」這種值能全球解鎖商業廣告；ad_snapshot_url 是唯一看得到素材的方法，API 本身只回文字與中繼資料；分頁是游標制，假設頁碼的腳本會無限迴圈。

三、不在歐盟的人該怎麼做

1. 網頁版加存成網址的篩選。 搜尋連結產生器把七個篩選變成一條可收藏的網址，每週打開看開始刊登日期，方法在檔案庫教學第五節。
2. 要歷史資料就用付費工具。 網頁版只有一年、沒有趨勢；把資料存下來的工具多了「跑多久」跟「什麼時候換」，哪一個值得買見廣告檔案庫 vs 間諜工具。
3. 不要自己養爬蟲。 檔案庫的頁面結構一年改好幾次，我們看過的廣告主自建爬蟲，沒有一個活過 6 個月。

其他平台是同一個形狀：TikTok 與 Google 的匯出也只涵蓋歐盟，LinkedIn 沒有 API，對照見各平台的廣告檔案庫。法規逼出來的透明度涵蓋歐盟，自願的透明度涵蓋政治廣告，其他地方的商業廣告到處都是網頁版限定。

四、三個常見的誤會

「有 API 就能監控對手」。 這是最常見的一個，我們每個月都會被問。API 的存在讓人以為 Meta 開放了資料，實際上開放的是法規要求的那一小塊。對投台灣市場的人，API 能查到的對手廣告是零，跟沒有 API 一樣。

「用歐盟國碼查就能看到全部」。 對，但看到的是「有投到歐盟」的廣告，不是廣告主的全部廣告。一個台灣品牌如果沒投歐盟，填 DE 一樣是零；一個跨國品牌投了歐盟，你看到的是他歐盟版的素材與受眾，不是台灣版的。拿歐盟資料推台灣策略，會推錯。

「第三方爬蟲 API 跟官方一樣穩」。 2026 年我們試過兩個把網頁版爬下來當 API 賣的服務，一個在 Meta 改版後停擺 11 天，另一個回傳的開始刊登日期有 3 成跟網頁版對不上。它們有用，但要每次跟網頁版抽查對照，而且不要把它接進任何自動決策。

五、什麼情況才值得申請

只有三種：你投歐盟或英國市場、你做的是政治或社會議題廣告、或你是研究者要拿政治廣告的花費資料。不在這三種裡，兩週的申請流程換來的是一個永遠回空清單的權杖。把時間拿去建素材庫，或者先把能投的帳號備齊，第一支廣告上線之前，API 不會出現在你的待辦清單裡。

---

來源與查證日期（2026-09-13）

• 廣告檔案庫 API: facebook.com/ads/library/api
• 研究用廣告檔案庫工具: Meta 透明度中心: transparency.meta.com
• ads_archive 參考文件: Meta for Developers: developers.facebook.com
• 數位服務法: 歐盟執委會: digital-strategy.ec.europa.eu