SiteData APISiteData API

Ads Transparency Statistics API

Overview of the Google Ads transparency statistics endpoint and its nine action modes.

Test API

Endpoint

GET /api/v1/ads-statistics

Authentication

Authorization: Bearer YOUR_API_KEY

Action Modes

Choose one action and follow the matching guide:

ActionPurposeCreditsGuide
advertiserSearchSearch advertisers by keyword1Advertiser Search API
domainSearchSearch domains by keyword1Domain Search API
advertiserStatisticsQuery weekly advertiser statistics3Advertiser Statistics API
domainStatisticsQuery weekly domain statistics3Domain Statistics API
titleSearchSearch domains by ad title keyword2Title Search API
domainTitlesQuery titles under a domain2Domain Titles API
domainImageAdsQuery image ads under a domain2Domain Image Ads API
domainTitleCountriesQuery country distribution for one domain title ad2Title Countries API
domainTitleImageAdsQuery image ads for one domain title2Title Image Ads API

Common Rules

  • action is required
  • advertiserStatistics, domainStatistics, titleSearch, domainTitles, domainImageAds, domainTitleCountries, and domainTitleImageAds require startDay and endDay
  • pass plain numeric advertiserId and hostId; the public API converts them internally
  • domainTitleCountries and domainTitleImageAds also require a raw title
  • public responses remove encryptedId, createTime, multi, and weeklyEndDay

Common Response Shape

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "ads-statistics",
    "action": "advertiserSearch",
    "costCredits": 1,
    "remainingCredits": 99,
    "query": {
      "action": "advertiserSearch",
      "keyword": "ai"
    },
    "result": []
  }
}

Shared Response Fields

FieldDescription
data.endpointFixed value: ads-statistics
data.actionExecuted action
data.costCreditsCredits consumed by this request
data.remainingCreditsRemaining credits after deduction
data.queryNormalized public request parameters
data.resultSanitized upstream result

On this page

Endpoint
Authentication
Action Modes
Common Rules
Common Response Shape
Shared Response Fields
Related