Ads Transparency Statistics API Documentation

Endpoint

GET https://api.goanyapi.com/api/v1/ads-statistics

GET https://api.goanyapi.com/api/v1/ads-statistics

Current configured costs by query mode: advertiserSearch: 5 credits; domainSearch: 5 credits; advertiserStatistics: 5 credits; domainStatistics: 5 credits; titleSearch: 5 credits; titleHostSearch: 5 credits; domainTitles: 5 credits; hostTitleSearch: 5 credits; domainImageAds: 5 credits; domainTitleCountries: 5 credits; domainTitleImageAds: 5 credits.

Authentication

Authorization: Bearer YOUR_API_KEY

Action Modes

Choose one action and follow the matching guide:

Action	Purpose	Required parameters	Prerequisite	Default credits	Guide
`advertiserSearch`	Search advertisers by keyword	`keyword`	None	`1`	Advertiser Search API
`domainSearch`	Search domains by keyword	`keyword`	None	`1`	Domain Search API
`advertiserStatistics`	Query weekly advertiser statistics	`advertiserId`, `startDay`, `endDay`	First call advertiserSearch, then pass an exact data.result[].id value as advertiserId.	`3`	Advertiser Statistics API
`domainStatistics`	Query weekly domain statistics	`hostId`, `startDay`, `endDay`	First call domainSearch, then pass an exact data.result[].id value as hostId.	`3`	Domain Statistics API
`titleSearch`	Search domains by ad title keyword	`keyword`, `startDay`, `endDay`	None	`2`	Title Search API
`titleHostSearch`	Return all domains matching an ad title keyword	`keyword`, `startDay`, `endDay`	None	`2`	Title Search API
`domainTitles`	Query titles under a domain	`hostId`, `startDay`, `endDay`	First call domainSearch, then pass an exact data.result[].id value as hostId.	`2`	Domain Titles API
`hostTitleSearch`	Page through titles under a domain	`hostId`, `startDay`, `endDay`	First call domainSearch, then pass an exact data.result[].id value as hostId.	`2`	Domain Titles API
`domainImageAds`	Query image ads under a domain	`hostId`, `startDay`, `endDay`	First call domainSearch, then pass an exact data.result[].id value as hostId.	`2`	Domain Image Ads API
`domainTitleCountries`	Query country distribution for one domain title ad	`hostId`, `title`, `startDay`, `endDay`	First call titleSearch or domainTitles and pass the same data.result[] item's hostId and exact title; alternatively call hostTitleSearch and use one data.result.items[] item's hostId and exact title.	`2`	Title Countries API
`domainTitleImageAds`	Query image ads for one domain title	`hostId`, `title`, `startDay`, `endDay`	First call titleSearch or domainTitles and pass the same data.result[] item's hostId and exact title; alternatively call hostTitleSearch and use one data.result.items[] item's hostId and exact title.	`2`	Title Image Ads API

Common Rules

action is required
required parameters vary by action and are listed in the Action Modes table
for multi-step actions, follow the Prerequisite column and reuse the exact response fields it names
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 48 Google Ads weekly buckets (days 1-7, 8-14, 15-21, and 22 through month-end) and return active rows only; other date-based actions have no configured span limit
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",
    "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 result

Ads Transparency Statistics API