Title Search API
按广告标题关键词搜索 Google Ads Transparency 域名。
接口地址
GET /api/v1/ads-statistics?action=titleSearch&keyword=ai&startDay=20260122&endDay=20260321请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | string | 是 | 固定值：titleSearch |
keyword | string | 是 | 搜索关键词 |
startDay | string | 是 | 日期格式 YYYYMMDD |
endDay | string | 是 | 日期格式 YYYYMMDD |
请求示例
GET /api/v1/ads-statistics?action=titleSearch&keyword=ai&startDay=20260122&endDay=20260321
Authorization: Bearer YOUR_API_KEY响应示例
{
"code": "ok",
"message": "ai image generator",
"data": {
"endpoint": "ads-statistics",
"action": "titleSearch",
"costCredits": 2,
"remainingCredits": 98,
"query": {
"action": "titleSearch",
"keyword": "ai",
"startDay": "20260122",
"endDay": "20260321"
},
"result": [
{
"endDay": 20260323,
"host": {
"domain": "apple.com",
"host": "apps.apple.com",
"id": 598
},
"hostId": 598,
"id": 5212742,
"startDay": 20260317,
"title": "Free AI Image Generator - Unlimited AI Image Design"
}
]
}
}响应字段
| 字段 | 说明 |
|---|---|
data.endpoint | 固定值 ads-statistics |
data.action | 固定值 titleSearch |
data.costCredits | 本次请求消耗积分 |
data.remainingCredits | 扣费后的剩余积分 |
data.query.action | 规范化后的 action |
data.query.keyword | 规范化后的关键词 |
data.query.startDay | 规范化后的开始日期 |
data.query.endDay | 规范化后的结束日期 |
data.result[].title | 广告标题 |
data.result[].startDay | 上游返回的开始日期 |
data.result[].endDay | 上游返回的结束日期 |
data.result[].host | 匹配到的 host 信息 |
data.result[].hostId | 明文 host ID |
data.result[].id | 上游标题记录 ID |