Title Countries API
Query the country distribution of one domain title ad.
Endpoint
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-31Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Fixed value: domainTitleCountries |
hostId | number | Yes | Plain host ID |
title | string | Yes | Raw ad title text |
startDay | string | Yes | Date in YYYY-MM-DD or YYYYMMDD |
endDay | string | Yes | Date in YYYY-MM-DD or YYYYMMDD |
Example
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_KEYResponse Example
{
"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]
]
}
}Response Fields
| Field | Description |
|---|---|
data.endpoint | Fixed value: ads-statistics |
data.action | Fixed value: domainTitleCountries |
data.costCredits | Credits consumed by this request |
data.remainingCredits | Remaining credits after deduction |
data.query.hostId | Plain host ID |
data.query.title | Raw title text |
data.query.startDay | Normalized start date |
data.query.endDay | Normalized end date |
data.result[] | Country distribution tuple |
data.result[][0] | Upstream row ID |
data.result[][1] | Country name |
data.result[][2] | Country code |
data.result[][3] | Ad count |