Google 广告库公司广告

按域或advertiser_id 从 Google 广告透明度库中获取公司的公共广告。

1 credits / 次请求

GET /v1/google/company/ads 试用

Google 广告库公司广告
GET /v1/google/company/ads

按域或advertiser_id 从 Google 广告透明度库中获取公司的公共广告。

鉴权：x-api-key
示例 URL: https://api.datawake.ai/v1/google/company/ads?domain=lululemon.com&advertiser_id=AR01614014350098432001&topic=all&region=US&start_date=2025-08-01&end_date=2025-08-11&get_ad_details=false&cursor=CgoAP7znOo9RPjf%252FEhD5utgx8m75NrTTbU0AAAAAGgn8%252BJyW%252BJQK40A%253D

参数：
- domain (query · string · 可选) = lululemon.com
- advertiser_id (query · string · 可选) = AR01614014350098432001
- topic (query · string · 可选) = all
- region (query · string · 可选) = US
- start_date (query · string · 可选) = 2025-08-01
- end_date (query · string · 可选) = 2025-08-11
- get_ad_details (query · string · 可选) = false
- cursor (query · string · 可选) = CgoAP7znOo9RPjf%2FEhD5utgx8m75NrTTbU0AAAAAGgn8%2BJyW%2BJQK40A%3D

概览

WakeScrap exposes this Google Ad Library endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

按域或advertiser_id 从 Google 广告透明度库中获取公司的公共广告。每个广告包括advertiserId、creativeId、format、adUrl、advertiserName、domain、firstShown 和lastShown。当 get_ad_details=true 时，每个请求花费 25 个积分；如果没有它，则仅以 1 个积分返回advertiserId 和creativeId。

可选查询参数可以组合在同一个请求里。

请求头

x-api-key string 必填

你的 Wake API 访问密钥。

示例：

YOUR_API_KEY

查询参数

domain string

公司域名

示例：

lululemon.com

advertiser_id string

公司的广告商ID

示例：

AR01614014350098432001

topic string

要搜索的主题。如果您搜索“政治”，您还需要传递“地区”，例如“美国”或“非洲联盟”

示例：

all

枚举： all, political

region string

要搜索的区域。默认到任何地方

示例：

start_date string

搜索的开始日期。格式：年-月-日

示例：

2025-08-01

end_date string

搜索的结束日期。格式：年-月-日

示例：

2025-08-11

get_ad_details string

设置为 true 以获取广告详细信息。将花费 25 个学分。

示例：

false

cursor string

光标对结果进行分页

示例：

CgoAP7znOo9RPjf%2FEhD5utgx8m75NrTTbU0AAAAAGgn8%2BJyW%2BJQK40A%3D


              curl 'https://api.datawake.ai/v1/google/company/ads?domain=lululemon.com&advertiser_id=AR01614014350098432001&topic=all&region=US&start_date=2025-08-01&end_date=2025-08-11&get_ad_details=false&cursor=CgoAP7znOo9RPjf%252FEhD5utgx8m75NrTTbU0AAAAAGgn8%252BJyW%252BJQK40A%253D' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/google/company/ads?domain=lululemon.com&advertiser_id=AR01614014350098432001&topic=all&region=US&start_date=2025-08-01&end_date=2025-08-11&get_ad_details=false&cursor=CgoAP7znOo9RPjf%252FEhD5utgx8m75NrTTbU0AAAAAGgn8%252BJyW%252BJQK40A%253D", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/google/company/ads?domain=lululemon.com&advertiser_id=AR01614014350098432001&topic=all&region=US&start_date=2025-08-01&end_date=2025-08-11&get_ad_details=false&cursor=CgoAP7znOo9RPjf%252FEhD5utgx8m75NrTTbU0AAAAAGgn8%252BJyW%252BJQK40A%253D",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/google/company/ads?domain=lululemon.com&advertiser_id=AR01614014350098432001&topic=all&region=US&start_date=2025-08-01&end_date=2025-08-11&get_ad_details=false&cursor=CgoAP7znOo9RPjf%252FEhD5utgx8m75NrTTbU0AAAAAGgn8%252BJyW%252BJQK40A%253D",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/google/company/ads?domain=lululemon.com&advertiser_id=AR01614014350098432001&topic=all&region=US&start_date=2025-08-01&end_date=2025-08-11&get_ad_details=false&cursor=CgoAP7znOo9RPjf%252FEhD5utgx8m75NrTTbU0AAAAAGgn8%252BJyW%252BJQK40A%253D", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/google/company/ads?domain=lululemon.com&advertiser_id=AR01614014350098432001&topic=all&region=US&start_date=2025-08-01&end_date=2025-08-11&get_ad_details=false&cursor=CgoAP7znOo9RPjf%252FEhD5utgx8m75NrTTbU0AAAAAGgn8%252BJyW%252BJQK40A%253D"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "success": true,
  "credits_remaining": 9926561,
  "ads": [
    {
      "advertiserId": "AR09628680369637163009",
      "creativeId": "CR15036700036807262209",
      "format": "text",
      "adUrl": "https://adstransparency.google.com/advertiser/AR09628680369637163009/creative/CR15036700036807262209",
      "advertiserName": "Foreplay Ventures Inc",
      "domain": "foreplay.co",
      "imageUrl": null,
      "firstShown": "2024-08-02T12:33:35.000Z",
      "lastShown": "2025-11-10T19:31:13.000Z"
    }
  ],
  "cursor": "CgoAP7zm82Y5sMRjEhBwPifBwIMxRttsqvUAAAAAGgn8%2BIdd%2BDICr8g%3D"
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}