Transparency Domain API
Search Google Ads transparency advertisers by domain.
Endpoint
GET /api/v1/transparency?domain=seedance2.artAuthentication
Authorization: Bearer YOUR_API_KEYRequest Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Domain used to search matched advertisers |
Validation Rules
domainis requiredkeywordandcreativeIdscannot be provided together withdomain
Example
GET /api/v1/transparency?domain=seedance2.art
Authorization: Bearer YOUR_API_KEYResponse Example
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "transparency",
"costCredits": 2,
"remainingCredits": 98,
"query": {
"domain": "seedance2.art"
},
"domain": "seedance2.art",
"totalItems": 4,
"advertisers": [
{
"advertiser": "华瑞洁",
"country": "CN",
"creativeIds": [
"AR02586610982767820801",
"AR17305550518470311937",
"AR04020344870890635265"
],
"adsCount": 31,
"resourceIds": [
"AR02586610982767820801",
"AR17305550518470311937",
"AR04020344870890635265"
]
}
],
"count": 1
}
}Response Fields
| Field | Description |
|---|---|
data.endpoint | Fixed value: transparency |
data.costCredits | Credits consumed by this request |
data.remainingCredits | Remaining credits after deduction |
data.query.domain | Original domain parameter |
data.domain | Normalized domain returned by the API |
data.totalItems | Total advertiser items from the upstream provider |
data.advertisers | Advertiser records associated with the domain |
data.count | Number of advertiser records returned |