Title Search API
按广告标题关键词搜索 Google Ads Transparency 域名。
接口地址
GET https://api.goanyapi.com/api/v1/ads-statistics?action=titleSearch&keyword=ai&startDay=20260122&endDay=20260321&page=0&size=10当前配置下，每次成功请求消耗 5 积分。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | string | 是 | 固定值：titleSearch |
keyword | string | 是 | 搜索关键词 |
startDay | string | 是 | 日期格式 YYYYMMDD 或 YYYY-MM-DD |
endDay | string | 是 | 日期格式 YYYYMMDD 或 YYYY-MM-DD |
page | integer | 否 | 从 0 开始的页码，默认 0 |
size | integer | 否 | 每页 1 到 100 条，默认 10 条 |
请求示例
GET /api/v1/ads-statistics?action=titleSearch&keyword=ai&startDay=20260122&endDay=20260321&page=0&size=10
Authorization: Bearer YOUR_API_KEY响应示例
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "ads-statistics",
"action": "titleSearch",
"costCredits": 2,
"remainingCredits": 98,
"query": {
"action": "titleSearch",
"keyword": "ai",
"startDay": "20260122",
"endDay": "20260321",
"page": "0",
"size": "10"
},
"result": {
"items": [
{
"hostId": 598,
"host": "apps.apple.com",
"domain": "apple.com",
"advertisers": [
{
"id": 42,
"advertiser": "示例广告商",
"country": "US",
"countryName": "United States",
"adCount": 7
}
]
}
],
"page": 0,
"size": 10,
"totalHosts": 125,
"totalPages": 13,
"hasMore": true
}
}
}响应字段
| 字段 | 说明 |
|---|---|
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.query.page | 标准化后的页码字符串 |
data.query.size | 标准化后的每页数量字符串 |
data.result.items[] | 当前页的域名列表 |
data.result.items[].hostId | 明文 host ID |
data.result.items[].host | 匹配到的 host |
data.result.items[].domain | 注册域名 |
data.result.items[].advertisers | 该域名的广告商摘要 |
data.result.items[].advertisers[].id | 明文广告商 ID |
data.result.items[].advertisers[].advertiser | 广告商名称 |
data.result.items[].advertisers[].country | 广告商国家代码 |
data.result.items[].advertisers[].countryName | 广告商国家名称 |
data.result.items[].advertisers[].adCount | 匹配广告数量 |
data.result.page | 当前页码 |
data.result.size | 当前每页数量 |
data.result.totalHosts | 匹配的域名总数 |
data.result.totalPages | 总页数 |
data.result.hasMore | 是否还有下一页 |