Title Image Ads API

查询某个域名标题对应的图片广告素材。

接口地址

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

请求参数

参数类型必填说明
actionstring固定值:domainTitleImageAds
hostIdnumber明文 host ID
titlestring原始广告标题
startDaystring日期格式 YYYY-MM-DDYYYYMMDD
endDaystring日期格式 YYYY-MM-DDYYYYMMDD

请求示例

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

响应示例

{
  "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"
    }
  }
}

响应字段

字段说明
data.endpoint固定值 ads-statistics
data.action固定值 domainTitleImageAds
data.costCredits本次请求消耗积分
data.remainingCredits扣费后的剩余积分
data.query.hostId明文 host ID
data.query.title原始标题文本
data.query.startDay规范化后的开始日期
data.query.endDay规范化后的结束日期
data.result以详情页 URL 为 key 的对象
data.result.<detailUrl>对应的图片素材地址

相关页面