# Index summary & trends

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

Aggregates your past /v1/geo/index results into KPIs and trends over a time window. No new AI calls, no charge. Pro gets totals and trends; group_by breakdowns are Scale and Enterprise only.

### Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `brand` | string | Yes | Brand, same as in index requests |
| `tag` | string | No | Only aggregate requests with this tag |
| `from / to` | string | No | Time window, ISO 8601. Default last 30 days |
| `interval` | string | No | Trend granularity: day, week, month. Default week |
| `engines` | string | No | Comma-separated engines to include |
| `kpis` | string | No | Comma-separated KPIs to return. Default: all for your plan |
| `group_by` | string | No | engine, intent, persona or prompt, one at a time. Scale only (Scale) |

### Example request

```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"
```

### Example response

```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
        }
      }
    }
  ]
}
```

- Some KPIs only exist in summaries, e.g. knowledge_half_life and category_capture_gap.
- Summaries use only your account’s index results. Only the answer cache is shared across accounts, never KPIs or tags.