Gloriads API 入门
创建 API 密钥，发出第一个请求并读懂返回结果。通过 Gloriads API，电子表格、脚本或自动化工具都能读取您的账户数据。
Gloriads API 让您自己的工具（电子表格、脚本、自动化流程）读取您的账户数据。
它是只读的。密钥只能读取账户，不会更改任何内容。所有套餐和免费试用期都包含 API。
如果只是想让 AI 助手查询您的账户，不需要密钥：请参阅连接 AI 助手。
1. 创建密钥
设置 → API → 创建密钥。 用将要使用它的工具来命名，然后复制密钥。密钥以 key_live_ 开头，只显示一次。
最多能有多少个密钥、如何吊销密钥：请参阅身份验证与 API 密钥。
2. 发出第一个请求
所有请求都发送到 https://gloriads.com/api/v1，并在 Authorization 请求头中携带密钥：
curl https://gloriads.com/api/v1/account \
-H "Authorization: Bearer YOUR_API_KEY"/account 用来确认密钥有效，返回密钥所属账户的信息，并说明您的亚马逊广告数据截至哪一天：
{
"is_demo": false,
"subscription": { "status": "active" },
"api_key": {
"name": "My script",
"start": "key_live_ab12",
"scopes": ["read"],
"created_at": "2026-09-15T07:55:00.000Z",
"last_used_at": null
},
"connected_app": null,
"amazon_ads": {
"connection": "connected",
"marketplaces": 3,
"performance_data": {
"currency": "USD",
"first_date": "2021-03-01",
"last_date": "2026-10-09",
"synced_at": "2026-10-10T06:12:00.000Z",
"is_syncing": false,
"history_complete": true
}
}
}如果 connection 为 error，请在设置 → 亚马逊广告中重新连接亚马逊广告：重新连接之前，数据会停止更新。
3. 查看所有端点
与更早周期对比的广告效果、商品、流媒体电视广告活动、广告活动及其关键词和广告、规则，以及 Gloriads 在亚马逊上做过的一切：API 可读取的数据列出了每个端点，并附示例。API 参考文档展示每个参数和响应，并提供 Try it 按钮。
限制
每个账户每分钟 60 次请求、每天 10,000 次请求。超出任一限制，API 会返回 429，并附带 Retry-After 响应头：请参阅限制与错误。