ZH
開始使用

Google · Ads

Google廣告詳情爬蟲 API

Google廣告詳情端點就是一次 API 呼叫:帶著你的 HProxy 金鑰送出網址,就會取回乾淨的結構化 JSON 物件。完整取得 Google 廣告透明度中心中的一則廣告:廣告素材、格式、廣告主和投放期間。HProxy 在伺服器端處理代理、工作階段、反機器人和解析,所以不必照顧無頭瀏覽器,Google改版時也不必一直修解析器。你只需要處理 JSON。
取得你的 API 金鑰Google API 參考文件
  • 每次 0.15¢
  • 每 1,000 次 US$ 1.49
  • 需要網址
  • 錯誤和逾時不收費

On Google

廣告

這個呼叫

一個 GET,廣告詳情就會以 JSON 回傳。

你的金鑰放在一個標頭中。1 required parameter, and the answer is the object below it.

完整參考文件
curl "https://hproxy.com/api/v1/scrape/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR01" \
  -H "X-API-Key: hpx_your_key_here"
回應200 OK · JSON
{
  "advertiser": { "name": "Brand Inc", "pageId": "104..." },
  "creatives": [
    { "format": "video", "body": "Shop the new drop", "media": "https://.../ad.mp4" }
  ],
  "spend": { "min": 5000, "max": 10000, "currency": "USD" },
  "dates": { "firstSeen": "2026-06-30", "lastSeen": "2026-07-17" }
}

回傳的內容

Google廣告詳情物件。

creatives[]
每則投放中廣告的媒體、文案和格式。
advertiser
投放廣告的專頁或廣告主。
spend / impressions
有揭露時提供花費區間和觸及人數。
dates
首次和最後一次出現的投放日期。

需要什麼

Parameters.

urlurlRequiredhttps://adstransparency.google.com/advertiser/AR01

目標網址(個人檔案、貼文或影片)。

trimbooleantrue

回傳精簡的內容(略去冗長的欄位)。

cache_max_agestring1d

Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.

運作方式

爬取Google廣告詳情,只要三個步驟。

你只要寫一行。代理、反機器人機制、渲染和解析都在我們這邊完成。

  1. 1

    建立免費帳號

    註冊並儲值任意金額。餘額可支付每一項 HProxy 產品。
  2. 2

    取得你的 API 金鑰

    儀表板上的一把金鑰就能驗證每個爬蟲。
  3. 3

    呼叫端點

    發送你需要的 GET,讀取 JSON。整合就這麼簡單。

大家用它做什麼

Google廣告詳情端點最能發揮價值的地方。

  • 掌握競爭對手的廣告素材和訊息。
  • 追蹤你所屬利基領域的廣告花費和活動時機。
  • 建立一份目前正在投放的內容參考庫。

Google廣告詳情常見問題

你還沒問,我們就先回答了。

參考文件

帶著網址和你的 HProxy API 金鑰,向Google廣告詳情端點發送一個經過驗證的 HTTPS 請求。完整取得 Google 廣告透明度中心中的一則廣告:廣告素材、格式、廣告主和投放期間。你這邊不需要代理、無頭瀏覽器或解析。回應就是可直接使用的 JSON。

這個端點每次成功呼叫 0.15¢,也就是每 1,000 次 US$ 1.49。從你的 HProxy 餘額扣款,不需訂閱,也沒有每月最低消費。錯誤會重試,而且從不收費;查詢的目標不存在時仍算一次呼叫。

這個 API 只存取公開可得的Google資料,也就是任何人都能在瀏覽器中打開的同一批頁面。依你的用途,你有責任依照適用法律和Google的條款使用這些資料。

包含Google公開提供的完整廣告詳情資料的結構化 JSON 物件。請見上方列出的欄位。每次呼叫的結構都一致,所以只要整合一次就能依賴它。

不需要。每次呼叫都在幕後使用 HProxy 自己的住宅網路執行,所以請求看起來像真實使用者。代理這一層已經包含在每次呼叫的價格中。

文件與 AI

隨時把你的爬蟲連接到 AI。

整個爬蟲 API 都以 Markdown 發布,因此 AI 助理不需要金鑰,就能讀取每個端點、每個參數與一份真實回應,並幫你寫好整合程式。而且由於每次爬取都是一個以 JSON 回應的 GET,代理程式可以用你的金鑰,依照自己的排程自行執行爬蟲。

閱讀爬蟲文件設定你的 AI 助理

Claude、ChatGPT、Cursor、Gemini、Copilot、Windsurf、Perplexity、Ollama,以及任何支援 MCP 的助理。

AI 代理程式可以呼叫它

用你的金鑰發一個 GET,就能取得結構化的 JSON,代理程式可以依照自己的排程爬取。沒有瀏覽器要操控,也沒有解析器要在每次執行之間維護。

查看端點

MCP 伺服器與 CLI

由我們為免費工具打造並架設在 mcp.hproxy.com:代理清單、檢測工具與 IP 查詢,以工具形式出現在 Claude、ChatGPT、Cursor 或任何支援 MCP 的 AI 助理中。無須安裝,不需要金鑰。

新增到你的 AI 助理

API 文件

每個爬蟲端點都有完整文件,包含它接受的參數與它實際傳回的回應。

閱讀文件

其他平台上的廣告

另外 2 個個平台上也有相同的資料。

一把金鑰,一種 JSON 形狀,一個餘額。換到其他平台,也不必學第二套 API。

Ad Library API

更多關於Google廣告詳情 API

Google 廣告詳情 端點會回傳什麼

完整取得 Google 廣告透明度中心中的一則廣告:廣告素材、格式、廣告主和投放期間。 JSON 物件包含 creatives[], advertiser, spend / impressions和dates。 我們這邊不會摘要刪減任何內容,所以你在回應中讀到的,就是 Google 廣告詳情 頁面本身的內容。

你要傳給 Google 廣告詳情 API 的內容

呼叫需要 網址。 必填:url。 選填:trim和cache_max_age。 金鑰放在 X-API-Key 標頭中傳送,回應是 JSON,每次呼叫收費 0.15¢,也就是每 1,000 次 US$ 1.49。

其他平台上的廣告

同樣的 廣告 資料也能在另外 2 個平台取得:Facebook 廣告檔案庫詳情和LinkedIn 廣告詳情。 它們與這個端點共用相同的 JSON 結構、按次計費與你的同一把 API 金鑰,所以從 Google 換到另一個網路只要換網址,不必再做一次整合。

爬取Google廣告詳情是允許的嗎?

這個端點讀取公開可得的Google資料,也就是任何人不登入就能在瀏覽器中打開的同一批頁面。它不會碰私人帳號或任何需要密碼的內容。之後如何使用這些資料,由你依照適用於你和Google的規定確保合法。

隨時為你準備好。

你的控制台只要十秒就到。不用業務電話,免訂閱,沒有最低金額。