# サマリー

Source: https://aiand-docs-staging.pages.dev/ja/analytics/summary/

```http
GET /analytics/summary?range=<range>
```

指定した期間のリクエスト件数と入力・出力トークンの合計、それより前の期間の合計、および現在の期間のトークン時系列を返します。"代表値" を表示する用途に向いています。

## クエリパラメータ

| パラメータ | 型 | 必須 | 説明 |
|-----------|------|------|------|
| `range` | string | 必須 | `1h`、`24h`、`7days`、`30days`、`3months` のいずれか。 |

## レスポンス

```json
{
  "current": {
    "requests": 87432,
    "input_tokens": 12345678,
    "output_tokens": 234567
  },
  "previous": {
    "requests": 80110,
    "input_tokens": 11023456,
    "output_tokens": 198765
  },
  "timeseries": [
    { "timestamp": "2026-05-11T00:00:00", "tokens": 1804321 },
    { "timestamp": "2026-05-11T01:00:00", "tokens": 1756789 }
  ]
}
```

## キャッシュ

レスポンスは singleflight 重複排除付きで **120 秒** キャッシュされます。

## 認証

API キー、または JWT + `X-Org-ID`。[認証](/ja/authentication/) を参照。

<Aside type="tip">
  リクエスト単位の詳細とカーソルページネーションが必要な場合は [リクエストログ](/ja/analytics/logs/) を利用してください。
</Aside>