Advertiser Statistics API
查询 Google Ads Transparency 的广告商周统计数据。
接口地址
GET /api/v1/ads-statistics?action=advertiserStatistics&advertiserId=39687&startDay=2026-03-01&endDay=2026-03-31请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | string | 是 | 固定值：advertiserStatistics |
advertiserId | number | 是 | 明文广告商 ID |
startDay | string | 是 | 日期格式 YYYY-MM-DD |
endDay | string | 是 | 日期格式 YYYY-MM-DD |
请求示例
GET /api/v1/ads-statistics?action=advertiserStatistics&advertiserId=39687&startDay=2026-03-01&endDay=2026-03-31
Authorization: Bearer YOUR_API_KEY响应示例
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "ads-statistics",
"action": "advertiserStatistics",
"costCredits": 3,
"remainingCredits": 97,
"query": {
"action": "advertiserStatistics",
"advertiserId": "39687",
"startDay": "2026-03-01",
"endDay": "2026-03-31"
},
"result": {
"adsAdvertiser": {
"advertiser": "ai.law",
"country": "US",
"countryName": "United States",
"id": 39687
},
"hostWeekStatistics": [
{
"adCount": 8,
"host": {
"domain": "ai.law",
"host": "www.ai.law",
"id": 141835
},
"month": 202603,
"week": 1
}
],
"weekHostStatistics": [
{
"month": 202603,
"week": 1,
"adsHostAdvertiserWeeklyList": [
{
"adCount": 8,
"advertiserId": 39687,
"hostId": 141835,
"month": 202603,
"week": 1,
"host": {
"domain": "ai.law",
"host": "www.ai.law",
"id": 141835
},
"advertiser": {
"advertiser": "ai.law",
"country": "US",
"countryName": "United States",
"id": 39687
},
"countries": [
{
"adCount": 8,
"country": "US",
"countryName": "United States"
}
]
}
]
}
]
}
}
}响应字段
| 字段 | 说明 |
|---|---|
data.endpoint | 固定值 ads-statistics |
data.action | 固定值 advertiserStatistics |
data.costCredits | 本次请求消耗积分 |
data.remainingCredits | 扣费后的剩余积分 |
data.query.action | 规范化后的 action |
data.query.advertiserId | 明文广告商 ID |
data.query.startDay | 规范化后的开始日期 |
data.query.endDay | 规范化后的结束日期 |
data.result.adsAdvertiser | 广告商信息 |
data.result.hostWeekStatistics | 广告商按域名拆分的周统计 |
data.result.hostWeekStatistics[].host | 当前行对应的域名信息 |
data.result.hostWeekStatistics[].adCount | 该周广告数量 |
data.result.weekHostStatistics | 按周分组的明细数据 |
data.result.weekHostStatistics[].adsHostAdvertiserWeeklyList | 周级明细列表 |
data.result.weekHostStatistics[].adsHostAdvertiserWeeklyList[].advertiserId | 明文广告商 ID |
data.result.weekHostStatistics[].adsHostAdvertiserWeeklyList[].hostId | 明文 host ID |
data.result.weekHostStatistics[].adsHostAdvertiserWeeklyList[].countries | 国家维度广告数量 |