Google 广告主的广告 API

curl -G "https://api.dataxapi.com/v1/google/advertisers/ads/list" \
  --data-urlencode "id=AR16735076323512287233" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

{
  "code": "ok",
  "request_id": "b9918ef3-6208-4850-af75-8aeda3dd491a",
  "data": {
    "items": [
      {
        "id": "AR14547762939695648498/CR16461126525097854516",
        "url": "https://adstransparency.google.com/advertiser/AR14547762939695648498/creative/CR16461126525097854516",
        "format": "image",
        "advertiser": {
          "id": "AR15686017776974616421",
          "name": "Lumen Outdoor"
        },
        "images": [],
        "first_shown_at": "2023-07-11T16:20:02.000Z",
        "last_shown_at": "2026-10-12T21:35:00.000Z"
      },
      // … 另有 39 条
    ]
  },
  "page": {
    "next_cursor": "c1.1CWjCp9ZBAq_fgH7qoredLVGrA5b_HMkWHgRd8A0",
    "cursor_expires_at": "2026-10-12T22:59:05.000Z",
    "has_more": true,
    "returned": 40
  },
  "warnings": [],
  "meta": {
    "capability": "google.advertisers.ads.list",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:59:05.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "title": "capability",
      "text": "capability",
      "landing_url": "capability",
      "advertiser.url": "platform",
      "advertiser.avatar_url": "platform",
      "videos": "capability"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

取自 2026-10-12 21:59 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

返回大小：标准档 16.2 KB（精简 13.9 KB，完整 16.2 KB）。

{
  "code": "ok",
  "request_id": "89a061cf-793a-4c1e-aac3-675c2cfc4a90",
  "data": { "items": [] },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 0
  },
  "warnings": [],
  "meta": {
    "capability": "google.advertisers.ads.list",
    "result_status": "empty",
    "fetched_at": "2026-10-12T21:58:31.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "title": "capability",
      "text": "capability",
      "landing_url": "capability",
      "advertiser.url": "platform",
      "advertiser.avatar_url": "platform",
      "videos": "capability"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

取自 2026-10-12 21:58 UTC 录下的真实返回。请求号和余额是示意。

返回大小：标准档 562 B（精简 562 B，完整 562 B）。

curl -G "https://api.dataxapi.com/v1/google/advertisers/ads/list" \
  --data-urlencode "id=AR16735076323512287233" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.google.advertisers.ads.list(id="AR16735076323512287233")
print(result["data"]["items"])

import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.google.advertisers.ads.list({ id: "AR16735076323512287233" });
console.log(result.data.items);

dataxapi call google.advertisers.ads.list id=AR16735076323512287233

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

把这段加进你的 MCP 客户端，然后让你的 AI 调用 google.advertisers.ads.list。