Transparency Domain API

按域名查询 Google Ads 透明度广告主信息。

接口地址

GET /api/v1/transparency?domain=seedance2.art

鉴权

Authorization: Bearer YOUR_API_KEY

请求参数

参数类型必填说明
domainstring用于查询广告主的域名

校验规则

  • domain 必填
  • 传入 domain 时不能同时传 keywordcreativeIds

请求示例

GET /api/v1/transparency?domain=seedance2.art
Authorization: Bearer YOUR_API_KEY

响应示例

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "transparency",
    "costCredits": 2,
    "remainingCredits": 98,
    "query": {
      "domain": "seedance2.art"
    },
    "domain": "seedance2.art",
    "totalItems": 4,
    "advertisers": [
      {
        "advertiser": "华瑞洁",
        "country": "CN",
        "creativeIds": [
          "AR02586610982767820801",
          "AR17305550518470311937",
          "AR04020344870890635265"
        ],
        "adsCount": 31,
        "resourceIds": [
          "AR02586610982767820801",
          "AR17305550518470311937",
          "AR04020344870890635265"
        ]
      }
    ],
    "count": 1
  }
}

响应字段

字段说明
data.endpoint固定值 transparency
data.costCredits本次请求消耗积分
data.remainingCredits扣费后的剩余积分
data.query.domain原始域名参数
data.domainAPI 返回的规范化域名
data.totalItems上游返回的广告主总条目数
data.advertisers与该域名相关的广告主记录
data.count返回的广告主记录数

相关页面