Ads Transparency Statistics API 文档

接口地址

GET https://api.goanyapi.com/api/v1/ads-statistics

GET https://api.goanyapi.com/api/v1/ads-statistics

当前配置按查询模式计费：advertiserSearch: 5 积分；domainSearch: 5 积分；advertiserStatistics: 5 积分；domainStatistics: 5 积分；titleSearch: 5 积分；titleHostSearch: 5 积分；domainTitles: 5 积分；hostTitleSearch: 5 积分；domainImageAds: 5 积分；domainTitleCountries: 5 积分；domainTitleImageAds: 5 积分。

鉴权方式

Authorization: Bearer YOUR_API_KEY

Action 模式

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

Action	说明	必填参数	前置调用	默认积分	文档
`advertiserSearch`	按关键词搜索广告主	`keyword`	无	`1`	Advertiser Search API
`domainSearch`	按关键词搜索域名	`keyword`	无	`1`	Domain Search API
`advertiserStatistics`	查询广告主周统计	`advertiserId`, `startDay`, `endDay`	请先调用 advertiserSearch，再将 data.result[].id 中的精确值作为 advertiserId 传入。	`3`	Advertiser Statistics API
`domainStatistics`	查询域名周统计	`hostId`, `startDay`, `endDay`	请先调用 domainSearch，再将 data.result[].id 中的精确值作为 hostId 传入。	`3`	Domain Statistics API
`titleSearch`	按广告标题关键词搜索域名	`keyword`, `startDay`, `endDay`	无	`2`	Title Search API
`titleHostSearch`	分页返回匹配广告标题关键词的域名摘要	`keyword`, `startDay`, `endDay`	无	`2`	Title Search API
`domainTitles`	查询域名下的标题	`hostId`, `startDay`, `endDay`	请先调用 domainSearch，再将 data.result[].id 中的精确值作为 hostId 传入。	`2`	Domain Titles API
`hostTitleSearch`	分页查询指定域名下的标题	`hostId`, `startDay`, `endDay`	请先调用 domainSearch，再将 data.result[].id 中的精确值作为 hostId 传入。	`2`	Domain Titles API
`domainImageAds`	查询域名下的图片广告	`hostId`, `startDay`, `endDay`	请先调用 domainSearch，再将 data.result[].id 中的精确值作为 hostId 传入。	`2`	Domain Image Ads API
`domainTitleCountries`	查询某个标题广告的国家分布	`hostId`, `title`, `startDay`, `endDay`	请先调用 domainTitles，并传入同一条 data.result[] 结果中的 hostId 和精确 title；也可调用 hostTitleSearch，并使用同一条 data.result.items[] 结果中的 hostId 和精确 title。	`2`	Title Countries API
`domainTitleImageAds`	查询某个标题广告的图片素材	`hostId`, `title`, `startDay`, `endDay`	请先调用 domainTitles，并传入同一条 data.result[] 结果中的 hostId 和精确 title；也可调用 hostTitleSearch，并使用同一条 data.result.items[] 结果中的 hostId 和精确 title。	`2`	Title Image Ads API

通用规则

action 必填
每种 action 的必填参数不同，以 Action 模式表为准
多步骤 action 必须按“前置调用”列执行，并使用其中指定的精确响应字段
titleSearch 支持 page、size，默认返回 10 条域名摘要，size 最大为 100；hostTitleSearch 也支持 page、size
域名摘要不包含标题数量；请求该域名的第一页 hostTitleSearch，从返回的 total 字段取得标题总数
advertiserStatistics 和 domainStatistics 最多覆盖 48 个 Google Ads 周期（每月 1-7 日、8-14 日、15-21 日、22 日至月底），并且只返回活跃周统计行；其他需要日期的 action 当前没有配置跨度限制
如果统计请求仍超过 20,000 条活跃周统计行，接口会返回错误并要求缩小日期范围
对外接口使用明文数字 advertiserId 和 hostId，服务端会自动转换
domainTitleCountries 和 domainTitleImageAds 额外需要传原始 title
返回结果会移除 encryptedId、createTime、multi、weeklyEndDay

通用响应结构

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "ads-statistics",
    "action": "advertiserSearch",
    "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