treg广告API实战Meta Ads、Google Ads、TikTok Ads按次调用的秘密【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg 是一个面向 Agent 的 OpenRouter它把 3000 多个第三方接口包括 Meta Ads、Google Ads、TikTok Ads 广告 API收进同一个目录用一把 token、一个地址按次调用从一分钱起步无需在各广告平台注册开发者账号。本文带你走通三大广告平台的调用路径并拆解按次计费背后的机制。为什么广告 API 适合按次调用传统做法是给每个平台各开一个开发者账号Meta 要身份验证、Google Ads 要申请 developer token、TikTok 的 OAuth 还走非标准协议。而大多数团队的广告研究是脉冲式的——只在投放前后查几天数据。按次调用pay-per-call意味着零订阅不用为 $99$249/月的广告分析工具买单零密钥暴露平台密钥由 treg 服务端注入Agent 本地不落任何 provider key失败不计费上游调用失败不收钱成功但响应丢失时可用 Idempotency-Key 取回已存结果新团队注册还能领$1.00 免费额度够跑几百次查询。方式一连上自己的账号免费读自己的投放数据treg 把每个平台自己的广告 API 都编成了目录条目OAuth 连接一次后读取调用本身不花钱消耗的是各平台的免费 API 额度。三个平台的目录定义平台目录文件可调用的核心工具Meta Adsmeta-ads.yaml广告账户列表、活动状态与预算、花费/曝光/点击/转化报告Google Adsgoogle-ads.yamlGAQL 查询、关键词创意与搜索量TikTok Adstiktok-ads.yaml广告主列表、集成报表、活动/广告组/广告创意Meta Ads连接后meta-ads.accounts返回你能管理的广告账户带act_前缀的 id接着用meta-ads.campaigns看活动预算用meta-ads.insights拉花费、CTR、CPM 和转化。金额字段注意是分minor unit字符串5000表示 $50.00——这些坑treg 都写进了端点说明里Agent 直接能读懂。Google Ads最强大也最容易踩坑的平台。每个请求要同时携带 OAuth token和manager 账号的developer-token通常还要login-customer-id。treg 的做法是把 developer token绑定在工具上由代理在出站时注入——Agent 两边都不用管。连上后就能跑 GAQL比如一条语句看 30 天花费与点击金额是 micros除以 100 万。附带福利google.keywords.ideas和google.keywords.volume等于免费用上了 Google 自己的关键词规划器这是别的按量数据商要收费的。TikTok Adstreg 目录里特别标注了两个形状惊喜——认证头是Access-Token而不是常见的Authorization: Bearer且成败都返回 HTTP 200要看响应体里的code。这些细节被固化在 tiktok-ads.yaml 的注释中保证 Agent 调用时不会把失败当成功。tiktok-ads.query可按活动维度拉花费、转化与成本窗口一般限 30 天内。方式二不连账号按次查竞品的广告如果你的目标是研究竞争对手而不是看自家数据可以直接调目录里的广告库Ad Library工具按次付费、无需任何平台身份广告库提供商单次价格Meta 广告库ScrapeCreators$0.00188/次Meta 广告库Apify$0.005/条广告Google Ads 透明中心DataForSEO$0.0006 起TikTok 广告库Apify$0.003一次跨四个平台拉竞品广告的完整 runtreg 官方实测花费$0.0075——对比 Optmyzr Revealbot Adalysis 的 $447/月差距一目了然。更多定价细节见 usecase-ads.html。按次调用的秘密代理只转发密钥不出服务端treg 的核心规则是relays, never models代理只做转发与认证注入不改写请求。这就是按次调用能成立的原因——一次注册处处可用把平台的 OAuth 连接或密钥注册进团队后每个 Agent 调用同一 endpoint id 都自动带上正确凭据自己的密钥永远优先你注册过的 key 会覆盖 treg 的共享 key且这类调用永不计费每次调用可审计余额、耗时、成功率都记录在案treg balance一句话算清刚才那步花了多少另一个容易忽略的机制在转化回传侧treg 自己投广告时用了一个持久化 outboxadsconv.py把 signup、首次调用、首次付费三个转化事件写进数据库后台每 300 秒批量上传给 Google Ads API。丢失一个转化事件会让竞价模型低估活动效果——所以它故意不用可丢弃的审计通道。完整设计文档在 ads-conversions.md。上手指南从登录到第一次广告 API 调用treg login # 登录GitHub 或邮箱验证码 treg catalog search ad accounts # 按用途搜广告工具 treg balance # 查看余额与本次花费然后在面板里连接你的 Meta / Google Ads 账号OAuth 弹窗授权一次即可之后让 Agent 直接说人话查一下我 Meta 账户最近 7 天的花费和 CTR——它会自动选中meta-ads.insights并把结果整理出来。相关资料入口项目定位与两种工具模型README.md三大平台端点定义src/treg/catalog/广告转化跟踪架构docs/context/architecture/ads-conversions.md竞品广告研究场景页src/treg/web/usecase-ads.html一句话总结Meta Ads 看洞察、Google Ads 跑 GAQL、TikTok Ads 拉报表一套 token 全打通自己的数据免费查竞品的数据几厘钱一次。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
