Title Countries API
查询某个域名标题广告的国家分布。
接口地址
GET /api/v1/ads-statistics?action=domainTitleCountries&hostId=132&title=Ask%20ChatGPT%20anything%20for%20free%20-%20ChatGPT:%20fast%20answers,%20anytime&startDay=2026-03-08&endDay=2026-03-31请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | string | 是 | 固定值：domainTitleCountries |
hostId | number | 是 | 明文 host ID |
title | string | 是 | 原始广告标题 |
startDay | string | 是 | 日期格式 YYYY-MM-DD 或 YYYYMMDD |
endDay | string | 是 | 日期格式 YYYY-MM-DD 或 YYYYMMDD |
请求示例
GET /api/v1/ads-statistics?action=domainTitleCountries&hostId=132&title=Ask%20ChatGPT%20anything%20for%20free%20-%20ChatGPT:%20fast%20answers,%20anytime&startDay=2026-03-08&endDay=2026-03-31
Authorization: Bearer YOUR_API_KEY响应示例
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "ads-statistics",
"action": "domainTitleCountries",
"costCredits": 2,
"remainingCredits": 98,
"query": {
"action": "domainTitleCountries",
"hostId": "132",
"title": "Ask ChatGPT anything for free - ChatGPT: fast answers, anytime",
"startDay": "20260308",
"endDay": "20260331"
},
"result": [
[2203, "Czechia", "CZ", 1],
[2276, "Germany", "DE", 1],
[2528, "Netherlands", "NL", 1]
]
}
}响应字段
| 字段 | 说明 |
|---|---|
data.endpoint | 固定值 ads-statistics |
data.action | 固定值 domainTitleCountries |
data.costCredits | 本次请求消耗积分 |
data.remainingCredits | 扣费后的剩余积分 |
data.query.hostId | 明文 host ID |
data.query.title | 原始标题文本 |
data.query.startDay | 规范化后的开始日期 |
data.query.endDay | 规范化后的结束日期 |
data.result[] | 国家分布元组 |
data.result[][0] | 上游记录 ID |
data.result[][1] | 国家名称 |
data.result[][2] | 国家代码 |
data.result[][3] | 广告数量 |