Google Ads API

Google Ads 广告详情 API

通过 URL 查询 Google Ads Transparency Center 中的单个广告素材,获取其格式、投放日期、展示次数区间、地区和素材变体,以干净的 JSON 返回。

US$1.20/千次请求,按请求付费,无需订阅。

Ad details - notion.com - Google Ads Transparency Center
adstransparency.google.com/advertiser/AR13309761427309854721/creative/CR00826878176251609089
Ads Transparency Center
Homenotion.comAd detailsFAQ

Ad details

notion.com

The information about this ad may vary by location

Last shown: Nov 2, 2026Format: video
Report this ad
1 of 3 variations

Sponsored

N

notion.com

notion.com

Work faster together with Notion

Plan, collaborate, and build faster together with Notion

See more ads by this advertiser
API 返回的内容regions[0]
{
"code": "GR",
"name": "Greece"
}
可用率
98.70%
30d · 16,340 次调用
请求数
16,340
30d · 按周,近 12 周
响应时间
2.4s
中位数 · 30d

价格

Google Ads 广告详情 API 价格

你需支付
US$12.00
US$1.20/千次请求,只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额,你的前 83 次请求免费。

试一试

一个请求获取 Google Ads 广告详情

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

这个示例展示了 20 个字段中的 19 个。查看全部字段

{
  "found": true,
  "data": {
    "advertiserId": "AR13309761427309854721",
    "creativeId": "CR00826878176251609089",
    "format": "video",
    "firstShown": "2026-06-17T00:00:00.000Z",
    "lastShown": "2026-11-02T16:06:37.000Z",
    "impressionsMin": 3000,
    "impressionsMax": 4000,
    "url": "https://adstransparency.google.com/advertiser/AR13309761427309854721/creative/CR00826878176251609089",
    "regions": [
      {
        "code": "GR",
        "name": "Greece"
      },
      {
        "code": "LU",
        "name": "Luxembourg"
      },
      {
        "code": "BE",
        "name": "Belgium"
      },
      {
        "code": "SG",
        "name": "Singapore"
      },
      {
        "code": "DE",
        "name": "Germany"
      },
      {
        "code": "CO",
        "name": "Colombia"
      },
      {
        "code": "FI",
        "name": "Finland"
      },
      {
        "code": "IT",
        "name": "Italy"
      },
      {
        "code": "RO",
        "name": "Romania"
      },
      {
        "code": "MX",
        "name": "Mexico"
      },
      {
        "code": "ZA",
        "name": "South Africa"
      },
      {
        "code": "BR",
        "name": "Brazil"
      },
      {
        "code": "ES",
        "name": "Spain"
      },
      {
        "code": "NO",
        "name": "Norway"
      },
      {
        "code": "AT",
        "name": "Austria"
      },
      {
        "code": "FR",
        "name": "France"
      },
      {
        "code": "PT",
        "name": "Portugal"
      },
      {
        "code": "NL",
        "name": "Netherlands"
      }
    ],
    "variations": [
      {
        "headline": "Work faster together with Notion",
        "description": "Plan, collaborate, and build faster together with Notion",
        "allText": "",
        "destinationUrl": "https://www.notion.com/lp/ent?nid=ddvmq9t",
        "imageUrl": ""
      },
      {
        "headline": "All your docs, in one spot",
        "description": "Work faster with AI that helps you write, plan, and organize in Notion",
        "allText": "",
        "destinationUrl": "https://www.notion.com/lp/ent?nid=ddvmq9t",
        "imageUrl": ""
      },
      {
        "headline": "All your docs, in one spot",
        "description": "Bring notes, docs, and AI together in one powerful workspace with Notion",
        "allText": "",
        "destinationUrl": "https://www.notion.com/lp/ent?nid=ddvmq9t",
        "imageUrl": ""
      }
    ]
  }
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

一个请求,一种响应结构。

你发送的每个字段和收到的每个字段,都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON,POST 到这个接口。

  • urlstring

    https://adstransparency.google.com/advertiser/AR13309761427309854721/creative/CR00826878176251609089

    Google Ads Transparency Center 广告素材 URL(例如 "https://adstransparency.google.com/advertiser/AR.../creative/CR...")。

你发送。 一个简短的 JSON 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

datadata
  • advertiserIdstring

    AR13309761427309854721

    Populated whenever the provider has data for the entity.

  • creativeIdstring

    CR00826878176251609089

    Populated whenever the provider has data for the entity.

  • firstShownstring

    2026-06-17T00:00:00.000Z

    ISO 8601 date.

  • formatstring

    video

    Populated whenever the provider has data for the entity.

  • impressionsMaxinteger

    4000

    Upper bound of the impressions range. Null when Google does not publish one for this creative.

  • impressionsMininteger

    3000

    Lower bound of the impressions range. Null when Google does not publish one for this creative.

  • lastShownstring

    2026-11-02T16:06:37.000Z

    ISO 8601 date.

  • urlstring

    https://adstransparency.google.com/advertiser/AR13309761427309854721/creative/CR00826878176251609089

    Google Ads Transparency Center URL for the creative.

each regiondata.regions[]

Regions where Google shows this creative. Empty when Google lists none.

  • codestring

    GR

    Two-letter region code, e.g. US.

  • namestring

    Greece

    Region name, e.g. United States.

each variationdata.variations[]

Populated whenever the provider has data for the entity.

  • allTextstring

  • descriptionstring

    Plan, collaborate, and build faster together with Notion

  • destinationUrlstring

    https://www.notion.com/lp/ent?nid=ddvmq9t

  • headlinestring

    Work faster together with Notion

  • imageUrlstring

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

你收到。 字段有名称、有类型,无论哪个数据源响应,结构都一样。

常见问题

关于 Google Ads 广告详情 API

AnyAPI 的 Google Ads 广告详情 API 只需一次 POST 请求 /v1/run/google_ads.ad_details,就以统一格式的 JSON 返回 Google Ads 数据。通过 URL 查询 Google Ads Transparency Center 中的单个广告素材,获取其格式、投放日期、展示次数区间、地区和素材变体,以干净的 JSON 返回。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Google Ads 广告详情 API 调用中有 98.7% 成功,响应时间中位数为 2.4 秒,共测量 16,340 次调用。

费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

通过 URL 查询 Google Ads Transparency Center 中的单个广告素材,获取其格式、投放日期、展示次数区间、地区和素材变体,以干净的 JSON 返回。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 Google Ads 广告详情 API 调用中有 98.7% 成功,响应时间中位数为 2.4 秒,共测量 16,340 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 83 次 Google Ads 广告详情,每次 US$0.0012。

向 https://api.getanyapi.com/v1/run/google_ads.ad_details 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。