Ads Transparency Statistics API

Endpoint

GET /api/v1/ads-statistics

Authentication

Authorization: Bearer YOUR_API_KEY

Action Modes

Choose one action and follow the matching guide:

Action	Purpose	Credits	Guide
`advertiserSearch`	Search advertisers by keyword	`1`	Advertiser Search API
`domainSearch`	Search domains by keyword	`1`	Domain Search API
`advertiserStatistics`	Query weekly advertiser statistics	`3`	Advertiser Statistics API
`domainStatistics`	Query weekly domain statistics	`3`	Domain Statistics API
`titleSearch`	Search domains by ad title keyword	`2`	Title Search API
`titleHostSearch`	Return all domains matching an ad title keyword	`2`	Title Search API
`domainTitles`	Query titles under a domain	`2`	Domain Titles API
`hostTitleSearch`	Page through titles under a domain	`2`	Domain Titles API
`domainImageAds`	Query image ads under a domain	`2`	Domain Image Ads API
`domainTitleCountries`	Query country distribution for one domain title ad	`2`	Title Countries API
`domainTitleImageAds`	Query image ads for one domain title	`2`	Title Image Ads API

Common Rules

action is required
advertiserStatistics, domainStatistics, titleSearch, titleHostSearch, domainTitles, hostTitleSearch, domainImageAds, domainTitleCountries, and domainTitleImageAds require startDay and endDay
titleHostSearch returns all matching domain summaries; hostTitleSearch accepts page and size, where size must be between 1 and 100
domain summaries do not include title counts; request the first hostTitleSearch page and use its total field for that domain
advertiserStatistics and domainStatistics can cover at most 8 Google Ads weekly buckets and return active weekly rows only; zero-count rows are omitted
if a statistics request still produces more than 20,000 active weekly rows, the API returns an error and asks you to narrow the date range
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

Field	Description
`data.endpoint`	Fixed value: `ads-statistics`
`data.action`	Executed action
`data.costCredits`	Credits consumed by this request
`data.remainingCredits`	Remaining credits after deduction
`data.query`	Normalized public request parameters
`data.result`	Sanitized upstream result

Ads Transparency Statistics API

Endpoint

Authentication

Action Modes

Common Rules

Common Response Shape

Shared Response Fields

Related

On this page