Transparency Domain API

Search Google Ads transparency advertisers by domain.

Endpoint

GET /api/v1/transparency?domain=seedance2.art

Authentication

Authorization: Bearer YOUR_API_KEY

Request Parameters

ParameterTypeRequiredDescription
domainstringYesDomain used to search matched advertisers

Validation Rules

  • domain is required
  • keyword and creativeIds cannot be provided together with domain

Example

GET /api/v1/transparency?domain=seedance2.art
Authorization: Bearer YOUR_API_KEY

Response 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

FieldDescription
data.endpointFixed value: transparency
data.costCreditsCredits consumed by this request
data.remainingCreditsRemaining credits after deduction
data.query.domainOriginal domain parameter
data.domainNormalized domain returned by the API
data.totalItemsTotal advertiser items from the upstream provider
data.advertisersAdvertiser records associated with the domain
data.countNumber of advertiser records returned