首页 AI 用 Codex 写 TikTok Marketing API 报表脚本(2026):同步报表分页、40100 限流重试、QPS 等级与 codex exec 日报

用 Codex 写 TikTok Marketing API 报表脚本(2026):同步报表分页、40100 限流重试、QPS 等级与 codex exec 日报

让 Codex 写 TikTok Marketing API v1.3 报表脚本:report/integrated/get 分页、30 天日维度上限、40100/40016/40133 限流重试、Basic 到 Ultimate 的 QPS 等级与异步报表 2 QPS,再用 codex exec 生成日报。

最后更新:2026-11-16(TikTok API for Business v1.3、TikTok for Business MCP Server、Anthropic、OpenAI 官方文档均于当天查阅)

TikTok 报表自动化有两条路:让 Claude 通过 MCP 实时问数(见 Claude 自动生成 TikTok 广告日报与诊断),或者让 Codex 写一个稳定的拉数脚本,每天定时跑、结果可复核。这篇讲第二条:脚本怎么写、限流怎么处理,以及怎样让 Codex 只做「总结」而不碰帐户。

准备:开发者应用与访问令牌

官方步骤是:创建 TikTok for Business 帐号 → 注册开发者 → 创建开发者应用 → 广告主授权 → 认证 → 首次调用(Get started)。广告主授权后拿到的 auth_code 1 小时内有效且只能用一次,换取的长期访问令牌不会自动过期,但广告主取消授权后失效(Authentication):

# exchange the one-time auth_code (valid 1 hour) for a long-term access token
import os, requests
BASE = "https://business-api.tiktok.com/open_api/v1.3"
r = requests.post(f"{BASE}/oauth2/access_token/", json={
    "app_id": os.environ["TIKTOK_APP_ID"],
    "secret": os.environ["TIKTOK_APP_SECRET"],
    "auth_code": os.environ["TIKTOK_AUTH_CODE"],   # from the advertiser authorization redirect
}, timeout=30).json()
assert r["code"] == 0, r["message"]
token = r["data"]["access_token"]          # store in a secret manager, never in git
print("authorised advertisers:", r["data"].get("advertiser_ids"))

让 Codex 写这段代码时,在 AGENTS.md 里写明「令牌只从环境变量读、不打印、不提交」。

报表脚本:分页 + 限流重试

# pull_report.py - synchronous report with paging and throttle handling
import os, json, time, requests
BASE = "https://business-api.tiktok.com/open_api/v1.3"
H = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}

def get(path, params, tries=5):
    for i in range(tries):
        r = requests.get(BASE + path, headers=H, params=params, timeout=60).json()
        if r["code"] in (40100, 40016, 40133):        # throttled
            time.sleep(min(300, 15 * 2 ** i)); continue
        if r["code"] != 0:
            raise RuntimeError(f'{r["code"]} {r["message"]} {r.get("request_id")}')
        return r["data"]
    raise RuntimeError("still throttled")

def report(advertiser_id, start, end):
    page, rows = 1, []
    while True:
        d = get("/report/integrated/get/", {
            "advertiser_id": advertiser_id, "report_type": "BASIC",
            "data_level": "AUCTION_CAMPAIGN",
            "dimensions": json.dumps(["campaign_id", "stat_time_day"]),
            "metrics": json.dumps(["spend", "impressions", "clicks", "ctr", "cpc",
                                   "conversion", "cost_per_conversion"]),
            "start_date": start, "end_date": end,            # stat_time_day: max 30 days
            "page": page, "page_size": 1000})
        rows += d["list"]
        if page >= d["page_info"]["total_page"]:
            return rows
        page += 1

要点:dimensions 与 metrics 以 JSON 字符串传入;按 stat_time_day 拆天时最长 30 天;page_size 最大 1000;GMV Max 报表请改用 /gmv_max/report/get/(Run a synchronous report)。

限流等级

等级QPSQPMQPD
Basic(默认)10600864,000
Advanced201,2001,728,000
Premium301,8002,592,000
Ultimate503,0004,320,000
TikTok API for Business 开发者应用限流等级表

另外有接口级限制:异步报表创建(/report/task/create/)在所有等级都是 2 QPS、60 QPM、4,500 QPD;/ad/create/ 在 Basic 为 5 QPS(Rate limits)。

返回码怎么处理

返回码含义脚本怎么处理
0成功继续
40100应用级限流(该接口)退避重试;QPM 超限暂停 5 分钟,QPD 超限等到 UTC 0 点
40016请求过于频繁(应用级)同上
40133广告主级限流降低该广告主的调用频率
40011单次请求 ID 过多拆批
40050重复请求检查 request_id 是否重复使用
TikTok Marketing API 常见返回码与脚本处理方式表

注意 TikTok 的业务错误码通常在 HTTP 200 的响应体里,脚本要判断 code 字段而不是只看 HTTP 状态码(Return codes)。

让 Codex 写、测、跑

  1. 给 Codex 本文的接口说明和 AGENTS.md,请它写 pull_report.py 并附上用假数据的单元测试(不调用真实 API)。
  2. 人工审查代码,重点看令牌处理、重试上限和日期范围。
  3. 用 cron 或 CI 每天跑脚本,再用 codex exec 在只读沙盒里生成总结(
  4. codex exec
  5. )。
# nightly report: script pulls data, codex exec (read-only sandbox by default) writes the summary
python pull_report.py --days 8 > report.csv
codex exec --ephemeral --output-schema summary_schema.json -o summary.json \
  "Read report.csv. Summarise spend, CTR, CPC, conversions and CPA per campaign for \
yesterday vs the previous 7 days, list anomalies, propose (do not apply) budget changes."

常见坑

  • 把多个帐户放在同一循环里狂刷,触发 40133;按广告主错峰。
  • 跨时区帐户直接相加;先按帐户时区对齐日期。
  • QPD 用完后整天重试;QPD 在 UTC 0 点重置,脚本应直接停止并告警。

熊猫出海如何用 Claude、Codex 和 TikTok 广告帐户帮客户提升投放效率

这篇讲的是 Codex,但在实际服务中,熊猫出海会把 Claude、Codex 和 TikTok 广告帐户组合起来,帮出海企业更快跑完「开户与像素/事件 → 搭 Smart+ 系列 → 素材上传与预审 → 看报表与诊断 → 调预算与规则」这套重复工作,让投手把时间花在素材策略、出价判断和放量节奏上。

  • 广告帐户:使用企业自有的 TikTok 海外户;需要行业准入的(如游戏、金融等)按 TikTok 政策申请加白户;也可通过授权代理商开通海外代理户。所有帐户以企业真实主体开通、归企业使用,不出租、不共享,多帐户通过企业自己的商务中心(BC)管理。
  • Claude:通过 TikTok 官方 TikTok for Business MCP Server 用自然语言查报表、调用官方诊断代理、整理素材与 Smart+ 建系列方案,写入类工具一律先确认再执行。
  • Codex:写和维护 Marketing API v1.3 的 Python 脚本(报表拉取、限流重试、Smart+ 以 DISABLE 状态批量创建、request_id 幂等),在沙盒里运行并接入定时任务。
  • 人工把关:开启投放、提预算、改出价都由投手审核后执行;素材与落地页是否符合 TikTok 广告政策由人工最终确认。

这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 TikTok、Anthropic 或 OpenAI 的官方合作伙伴。开户与代投流程请看 TikTok 广告开户与投放(熊猫出海服务页)。

常见问题

用 MCP 不是更简单吗?

交互式问数用 MCP 更快;需要每天稳定跑、可审计、可回放的报表,用脚本更合适。

需要申请更高的 QPS 吗?

大多数中小广告主用 Basic 足够;确有需要时在 My Apps 里逐级申请,并写明理由。

Codex 会不会把令牌写进代码?

在 AGENTS.md 中禁止,并在代码审查和提交前扫描密钥。

能拉 GMV Max 的数吗?

可以,换用 /gmv_max/report/get/。GMV Max 实操见 GMV Max 投放实操:授权、建计划与 ROI 目标。

合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 TikTok 广告帐户(含商务中心 BC 下分配给你的帐户),通过 TikTok 官方 TikTok API for Business、TikTok for Business MCP Server 或 TikTok 广告管理平台接入,遵守 TikTok 广告政策、行业准入要求与 API 限流,并在任何会产生花费的动作前保留人工审核。TikTok 海外户、加白户、海外代理户都应由广告主以真实主体和资质开通、归广告主使用;熊猫出海不出售、出租、共享或转让广告帐户、BC 或 API 凭据,不协助规避广告审核、行业准入、地区限制或身份验证,也不是 TikTok、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。

相关阅读

联系熊猫出海:TikTok 广告开户 + AI 自动化投放

告诉我们公司主体所在地、行业(是否需要行业准入/加白)、目标国家、落地页/App/TikTok Shop 链接和预计月预算,以及你想先自动化哪一段(报表、素材、Smart+ 建系列还是规则)。我们先做资质与素材预审,再协助企业合规开通 TikTok 海外户、加白户或海外代理户,并把 Claude / Codex 接入你的投放流程。

WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

熊猫出海微信二维码 szcwh99

官方来源

以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/codex-tiktok-marketing-api-report-scripts-rate-limits-2026.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部