Transparency Keyword API
按关键词查询 Google Ads 透明度联想结果。
接口地址
GET /api/v1/transparency?keyword=ai%20image鉴权
Authorization: Bearer YOUR_API_KEY请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | string | 是 | 用于查询广告主和域名联想结果的关键词 |
校验规则
keyword必填- 传入
keyword时不能同时传domain或creativeIds
请求示例
GET /api/v1/transparency?keyword=ai%20image
Authorization: Bearer YOUR_API_KEY响应示例
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "transparency",
"costCredits": 2,
"remainingCredits": 98,
"query": {
"keyword": "ai image"
},
"keyword": "ai image",
"advertisers": [
{
"country": "BR",
"name": "AIMER IMAGE LTDA",
"id": "AR05962718198141812737",
"adsCount": 2
},
{
"country": "AT",
"name": "ImageTwin AI GmbH",
"id": "AR15865318654066294785",
"adsCount": 2
}
],
"domains": [
"maiimage.com",
"everyaiimage.com",
"aiimagetovideo.ai"
],
"count": 13
}
}响应字段
| 字段 | 说明 |
|---|---|
data.endpoint | 固定值 transparency |
data.costCredits | 本次请求消耗积分 |
data.remainingCredits | 扣费后的剩余积分 |
data.query.keyword | 原始关键词参数 |
data.keyword | API 返回的规范化关键词 |
data.advertisers | 与关键词相关的广告主联想结果 |
data.domains | 与关键词相关的域名联想结果 |
data.count | 返回的联想记录数 |