APIを使い始める

Gloriads APIを使うと、スプレッドシート、スクリプト、自動化ツールなど、ご自身のツールからアカウントを読み取れます。

APIは読み取り専用です。キーはアカウントを読み取るだけで、何も変更しません。APIはすべてのプランと無料トライアル中に利用できます。

AIアシスタントにアカウントについて質問するだけなら、キーは不要です。AIアシスタントを接続をご覧ください。

1. キーを作成する

設定 → API → キーを作成。キーを使うツールの名前を付けて、キーをコピーします。キーはkey_live_で始まり、表示されるのは1回だけです。

保持できるキーの数と無効にする方法は、認証とAPIキーをご覧ください。

2. 最初のリクエストを送る

すべてのリクエストはhttps://gloriads.com/api/v1に送り、Authorizationヘッダーにキーを含めます。

curl https://gloriads.com/api/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

/accountは、キーが機能することを確認し、キーが属するアカウントの情報と、Amazon Adsの数値がどの日までそろっているかを返します。

{
  "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の場合は、設定 → Amazon AdsでAmazon Adsを再接続してください。再接続するまで、数値は更新されません。

3. すべてのエンドポイントを確認する

過去の期間と比べた実績、商品、ストリーミングTV広告のキャンペーン、キーワードと広告を含むキャンペーン、ルール、そしてGloriadsがAmazonで行ったすべてのことを読み取れます。すべてのエンドポイントは、例とともにAPIで読み取れるものに掲載されています。APIリファレンスでは、すべてのパラメーターとレスポンスを確認でき、Try itボタンで試せます。

制限

アカウントごとに、1分あたり60リクエスト、1日あたり10,000リクエストです。どちらかを超えると、APIはRetry-Afterヘッダー付きで429を返します。制限とエラーをご覧ください。