App-wide usage for the last 7, 30, or 90 days: total metered events, total cost in cents, monthly active end users (MAU), a per-day event and cost series, a per-day active user series, and the top event types. Start here to understand what is happening in an app.

Request

curl "https://www.vevee.org/api/v1/analytics/overview?window=30" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Parameters

Response

data matches the InsightsOverview shape used internally.eventsByDay and usersByDay only contain rows for days that had activity; eventMix is capped at the top 10 event types by count.

{
  "ok": true,
  "data": {
    "windowDays": 30,
    "totalEvents": 48213,
    "totalCostCents": 921540,
    "mau": 1287,
    "eventsByDay": [
      { "date": "2026-07-30", "count": 1642, "costCents": 31280 },
      { "date": "2026-07-31", "count": 1798, "costCents": 34115 },
      { "date": "2026-08-01", "count": 1520, "costCents": 28904 }
    ],
    "usersByDay": [
      { "date": "2026-07-30", "count": 412 },
      { "date": "2026-07-31", "count": 447 },
      { "date": "2026-08-01", "count": 398 }
    ],
    "eventMix": [
      { "eventType": "image.render", "count": 21430, "costCents": 412990 },
      { "eventType": "llm.tokens", "count": 18902, "costCents": 356210 },
      { "eventType": "video.render", "count": 7881, "costCents": 152340 }
    ]
  }
}

Errors

• invalid_key (401) - bad or revoked API key.
• requires_secret_key (403) - a pk_* key was used.