# Index 集計とトレンド

`GET https://api.dataforgeo.dev/v1/geo/index/summary` · Pro / Scale / Enterprise

アカウント内で実行済みの /v1/geo/index 結果を期間で集計し、KPI とトレンドを返します。新たな AI 呼び出しはなく無料。Pro は全体とトレンド、group_by による分解は Scale・Enterprise のみ。

### パラメータ

| パラメータ | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `brand` | string | はい | ブランド名。index リクエストと同じ値 |
| `tag` | string | いいえ | このタグのリクエストのみ集計 |
| `from / to` | string | いいえ | 期間（ISO 8601）。既定は直近 30 日 |
| `interval` | string | いいえ | トレンド粒度：day、week、month。既定 week |
| `engines` | string | いいえ | カンマ区切りで対象エンジンを指定 |
| `kpis` | string | いいえ | カンマ区切りで返す KPI を指定。既定はプランの全 KPI |
| `group_by` | string | いいえ | engine・intent・persona・prompt のいずれか 1 つ。Scale のみ (Scale) |

### リクエスト例

```bash
curl "https://api.dataforgeo.dev/v1/geo/index/summary?brand=晓宅&tag=osaka-family-q4&interval=week&group_by=engine" \
  -H "x-api-key: YOUR_API_KEY"
```

### レスポンス例

```json
{
  "brand": "晓宅",
  "window": {
    "from": "2026-10-03T00:00:00Z",
    "to": "2026-11-02T00:00:00Z"
  },
  "answers_counted": 498,
  "kpis": {
    "findability": {
      "value": 42.1
    },
    "visibility": {
      "value": 0.262,
      "numerator": 130,
      "denominator": 498
    }
  },
  "series": [
    {
      "period": "2026-10-05",
      "visibility": 0.255,
      "share_of_voice": 0.018
    },
    {
      "period": "2026-10-12",
      "visibility": 0.263,
      "share_of_voice": 0.026
    }
  ],
  "groups": [
    {
      "key": "chatgpt",
      "answers_counted": 166,
      "kpis": {
        "visibility": {
          "value": 0.301
        }
      }
    },
    {
      "key": "gemini",
      "answers_counted": 166,
      "kpis": {
        "visibility": {
          "value": 0.241
        }
      }
    }
  ]
}
```

- 一部の KPI は集計でのみ提供されます（knowledge_half_life、category_capture_gap など）。
- 集計は自アカウントの index 結果のみを使います。アカウント間で共有されるのは回答キャッシュだけです。