Title Image Ads API

Query image ad sources for one domain title.

Endpoint

GET /api/v1/ads-statistics?action=domainTitleImageAds&hostId=132&title=AI%20image%20generation%20for%20free%20-%20Try%20for%20free%20on%20ChatGPT&startDay=2026-03-08&endDay=2026-03-31

Parameters

ParameterTypeRequiredDescription
actionstringYesFixed value: domainTitleImageAds
hostIdnumberYesPlain host ID
titlestringYesRaw ad title text
startDaystringYesDate in YYYY-MM-DD or YYYYMMDD
endDaystringYesDate in YYYY-MM-DD or YYYYMMDD

Example

GET /api/v1/ads-statistics?action=domainTitleImageAds&hostId=132&title=AI%20image%20generation%20for%20free%20-%20Try%20for%20free%20on%20ChatGPT&startDay=2026-03-08&endDay=2026-03-31
Authorization: Bearer YOUR_API_KEY

Response Example

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "ads-statistics",
    "action": "domainTitleImageAds",
    "costCredits": 2,
    "remainingCredits": 98,
    "query": {
      "action": "domainTitleImageAds",
      "hostId": "132",
      "title": "AI image generation for free - Try for free on ChatGPT",
      "startDay": "20260308",
      "endDay": "20260331"
    },
    "result": {
      "https://adstransparency.google.com/advertiser/AR02788840342533701633/creative/CR08717958822540345345?region=anywhere": "https://tpc.googlesyndication.com/archive/simgad/10973451835656886368"
    }
  }
}

Response Fields

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