Ads Transparency Statistics API

接口地址

GET /api/v1/ads-statistics

鉴权方式

Authorization: Bearer YOUR_API_KEY

Action 模式

传入一个 action，按对应说明调用：

Action	说明	积分	文档
`advertiserSearch`	按关键词搜索广告商	`1`	Advertiser Search API
`domainSearch`	按关键词搜索域名	`1`	Domain Search API
`advertiserStatistics`	查询广告商周统计	`3`	Advertiser Statistics API
`domainStatistics`	查询域名周统计	`3`	Domain Statistics API
`titleSearch`	按广告标题关键词搜索域名	`2`	Title Search API
`titleHostSearch`	返回匹配广告标题关键词的全部域名摘要	`2`	Title Search API
`domainTitles`	查询域名下的标题	`2`	Domain Titles API
`hostTitleSearch`	分页查询指定域名下的标题	`2`	Domain Titles API
`domainImageAds`	查询域名下的图片广告	`2`	Domain Image Ads API
`domainTitleCountries`	查询某个标题广告的国家分布	`2`	Title Countries API
`domainTitleImageAds`	查询某个标题广告的图片素材	`2`	Title Image Ads API

通用规则

action 必填
advertiserStatistics、domainStatistics、titleSearch、titleHostSearch、domainTitles、hostTitleSearch、domainImageAds、domainTitleCountries、domainTitleImageAds 需要传 startDay 和 endDay
titleHostSearch 返回全部匹配域名摘要；hostTitleSearch 支持 page、size，其中 size 必须在 1 到 100 之间
域名摘要不包含标题数量；请求该域名的第一页 hostTitleSearch，从返回的 total 字段取得标题总数
advertiserStatistics 和 domainStatistics 最多覆盖 8 个 Google Ads 周期，并且只返回活跃周统计行；广告数为 0 的行会省略
如果统计请求仍超过 20,000 条活跃周统计行，接口会返回错误并要求缩小日期范围
对外接口使用明文数字 advertiserId 和 hostId，服务端会自动转换
domainTitleCountries 和 domainTitleImageAds 额外需要传原始 title
返回结果会移除 encryptedId、createTime、multi、weeklyEndDay

通用响应结构

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "ads-statistics",
    "action": "advertiserSearch",
    "costCredits": 1,
    "remainingCredits": 99,
    "query": {
      "action": "advertiserSearch",
      "keyword": "ai"
    },
    "result": []
  }
}

通用响应字段

字段	说明
`data.endpoint`	固定为 `ads-statistics`
`data.action`	实际执行的 action
`data.costCredits`	本次请求消耗积分
`data.remainingCredits`	扣费后的剩余积分
`data.query`	规范化后的请求参数
`data.result`	清洗后的上游结果

Ads Transparency Statistics API

接口地址

鉴权方式

Action 模式

通用规则

通用响应结构

通用响应字段

相关页面

On this page