SiteData APISiteData API

Ads Transparency API

Overview of the Google Ads transparency endpoint and its three query modes.

Test API

Endpoint

GET /api/v1/transparency

Authentication

Authorization: Bearer YOUR_API_KEY

Query Modes

Choose exactly one of the following guides:

ModePurposeGuide
keywordSearch advertiser and domain suggestions by keywordTransparency Keyword API
domainFind advertisers associated with a domainTransparency Domain API
creativeIdsReverse lookup domains by creative IDsTransparency Creative IDs API

Validation Rules

  • keyword, domain, and creativeIds cannot be provided together
  • at least one of them must be provided

Common Response Shape

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "transparency",
    "costCredits": 2,
    "remainingCredits": 98
  }
}

Shared Response Fields

FieldDescription
data.endpointFixed value: transparency
data.costCreditsCredits consumed by this request
data.remainingCreditsRemaining credits after deduction

On this page

Endpoint
Authentication
Query Modes
Validation Rules
Common Response Shape
Shared Response Fields
Related