Domain Titles API
Query all ad titles under one domain.
Endpoint
GET /api/v1/ads-statistics?action=domainTitles&hostId=598&startDay=20260301&endDay=20260331Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Fixed value: domainTitles |
hostId | number | Yes | Plain host ID |
startDay | string | Yes | Date in YYYYMMDD |
endDay | string | Yes | Date in YYYYMMDD |
Example
GET /api/v1/ads-statistics?action=domainTitles&hostId=598&startDay=20260301&endDay=20260331
Authorization: Bearer YOUR_API_KEYResponse Example
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "ads-statistics",
"action": "domainTitles",
"costCredits": 2,
"remainingCredits": 98,
"query": {
"action": "domainTitles",
"hostId": "598",
"startDay": "20260301",
"endDay": "20260331"
},
"result": [
{
"endDay": 20260322,
"hostId": 132,
"startDay": 20250423,
"title": "AI image generation for free - Try for free on ChatGPT"
}
]
}
}Response Fields
| Field | Description |
|---|---|
data.endpoint | Fixed value: ads-statistics |
data.action | Fixed value: domainTitles |
data.costCredits | Credits consumed by this request |
data.remainingCredits | Remaining credits after deduction |
data.query.action | Normalized action name |
data.query.hostId | Plain host ID |
data.query.startDay | Normalized start date |
data.query.endDay | Normalized end date |
data.result[].title | Ad title text |
data.result[].startDay | Start day from upstream |
data.result[].endDay | End day from upstream |
data.result[].hostId | Plain host ID |