Domain Image Ads API

Query image ad assets under one domain.

Endpoint

GET /api/v1/ads-statistics?action=domainImageAds&hostId=598&startDay=20260301&endDay=20260331

Parameters

ParameterTypeRequiredDescription
actionstringYesFixed value: domainImageAds
hostIdnumberYesPlain host ID
startDaystringYesDate in YYYYMMDD
endDaystringYesDate in YYYYMMDD

Example

GET /api/v1/ads-statistics?action=domainImageAds&hostId=598&startDay=20260301&endDay=20260331
Authorization: Bearer YOUR_API_KEY

Response Example

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "ads-statistics",
    "action": "domainImageAds",
    "costCredits": 2,
    "remainingCredits": 98,
    "query": {
      "action": "domainImageAds",
      "hostId": "598",
      "startDay": "20260301",
      "endDay": "20260331"
    },
    "result": {
      "https://adstransparency.google.com/advertiser/AR02788840342533701633/creative/CR05409403162035486721?region=anywhere": "https://tpc.googlesyndication.com/archive/simgad/9793661073103132559",
      "https://adstransparency.google.com/advertiser/AR02788840342533701633/creative/CR08716171188432273409?region=anywhere": "https://tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/7034451900108615439/index.html"
    }
  }
}

Response Fields

FieldDescription
data.endpointFixed value: ads-statistics
data.actionFixed value: domainImageAds
data.costCreditsCredits consumed by this request
data.remainingCreditsRemaining credits after deduction
data.query.actionNormalized action name
data.query.hostIdPlain host ID
data.query.startDayNormalized start date
data.query.endDayNormalized end date
data.resultObject keyed by Ads Transparency detail URL
data.result.<detailUrl>Image asset or bundle URL