Title Search API
Search Google Ads transparency domains by ad title keyword.
Endpoint
GET /api/v1/ads-statistics?action=titleSearch&keyword=ai&startDay=20260122&endDay=20260321Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Fixed value: titleSearch |
keyword | string | Yes | Search keyword |
startDay | string | Yes | Date in YYYYMMDD |
endDay | string | Yes | Date in YYYYMMDD |
Example
GET /api/v1/ads-statistics?action=titleSearch&keyword=ai&startDay=20260122&endDay=20260321
Authorization: Bearer YOUR_API_KEYResponse Example
{
"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"
}
]
}
}Response Fields
| Field | Description |
|---|---|
data.endpoint | Fixed value: ads-statistics |
data.action | Fixed value: titleSearch |
data.costCredits | Credits consumed by this request |
data.remainingCredits | Remaining credits after deduction |
data.query.action | Normalized action name |
data.query.keyword | Normalized keyword |
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[].host | Matched host profile |
data.result[].hostId | Plain host ID |
data.result[].id | Upstream title row ID |