广告活动、标题与图片记录

谷歌竞品广告研究 API:周度活动与标题 JSON

先搜索可用的广告主或域名并复用精确 ID,再查询支持的周度活动、标题或图片记录。返回 JSON 可用于有依据的竞品研究,但不包含广告花费与转化。

先找对象 ID · 再选择对应查询模式

填写查询条件,检查请求预览后运行测试;如提供已保存示例,可先用示例查看响应。
5 积分
GET等待运行
https://api.goanyapi.com/api/v1/ads-statistics?action=advertiserSearch
可视化应用展示

运行后在这里查看可视化

响应会自动整理成指标、列表和表格,和右侧 JSON 一一对应。

运行后在这里查看响应

填入演示参数即可预览示例响应,不消耗积分;登录后可用自己的参数发起真实请求。

先取得精确的广告主 ID

第一次请求用于定位候选广告主。后续统计 action 需要实际返回的 ID 和各自的必填参数。

请求示例 · advertiserSearch
GET https://api.goanyapi.com/api/v1/ads-statistics?action=advertiserSearch&keyword=ai
Authorization: Bearer YOUR_API_KEY

真实匹配随关键词变化,因此这里只说明响应路径,不冒充已获取的结果。

主要响应路径

data.result[].id
后续 advertiserStatistics 的 advertiserId 应取此处的精确数字 ID。
data.action
本次实际执行的 action。
data.costCredits
按当前配置扣除的本次积分。
查看全部 action 与前置条件 →

这些数据可以帮助你做什么

先找对象 ID · 再选择对应查询模式

先找到正确对象

先通过 advertiserSearch 或 domainSearch 找到对象。匹配结果中的数字 id 可供后续统计 action 使用;不要只凭品牌名猜 ID,也不要混用广告主与网站标识。

观察周度活动

在文档规定的日期范围内查询广告主或域名周度活动。结果只返回活跃周期,缺失时间段不是完整的零花费或零投放时间序列。

继续研究素材方向

按研究问题选择标题或图片 action。关键词标题搜索、域名标题、标题出现国家和图片记录各有不同前置条件;后续请求应沿用上一步返回的精确标题与 host ID。

从实际问题到可用结果

围绕真实任务使用数据,并保留必要的解释边界。

先查广告主或网站

先用 advertiserSearch 或 domainSearch 搜索对象,检查 data.result[].id。再把精确 ID 用作对应 action 的 advertiserId 或 hostId。

再查具体时间与模式

为周度统计或标题查询设置聚焦的日期范围。advertiserStatistics 与 domainStatistics 须遵守文档中的 48 周期限制,结果过大时缩小范围。

形成有依据的分析

整理可观察的活动与标题记录,并保留对象 ID、查询日期和 action 名称。把结果作为研究证据,不将其写成花费、点击量或 ROI。

谷歌竞品广告统计 API常见问题

先确认适用范围、数据含义与接入方式,再决定如何使用。

不同。本页用于查询广告主、域名及可用的活动和素材记录,不管理广告账户,也不提供关键词规划师的指标。请根据研究任务选择文档列明的模式。

先用 advertiserSearch 或 domainSearch 找到对象,再把实际返回的 id 传给对应统计模式,并设置起止日期。不同步骤是单独请求。

titleSearch 返回匹配标题对应的域名汇总;googleAdsTitleSearch 返回匹配的标题与网站记录。需要广告标题内容时应选后者。

可使用 domainTitleCountries,传入 host ID、日期及标题查询实际返回的完整标题。标题和网站应来自同一条记录,不要自行拼接。

周度统计有文档列明的周期与行数限制,范围过大时应缩小。只返回活跃周期,缺失行不能直接当成连续的零投放记录。

结果不提供花费、CTR、销量或 ROI。可用于观察活动和素材模式,不能作为广告效果的证明。

按所选模式及当前配置费率计费,具体见测试区与文档。对象搜索、统计和后续查询是不同请求,不是付一次费用就覆盖整个研究流程。

可以使用 GoAnyAPI 密钥按文档发送 HTTP 请求并读取 JSON。AI 助手需要先连接 GoAnyAPI MCP,且对应工具可用;不能默认普通聊天已经接入。定时、存储和进一步分析需要由自己的流程完成。