Nutzungs-Insights abrufen

Liefert alles, was die /insights-Seite in einem Roundtrip benötigt: Trendreihen für alle 3 Metriken (Tokens/Ausgaben/Anfragen), Top-3-Modelle pro Metrik, Prompt-Cache-Trefferstatistik, Token-Aufschlüsselung, eine Jahres-Heatmap (mit Streak), Guthaben-/Freemodell-Nutzung und Filterpanel-Optionen. 5 Minuten pro Kombination aus (Nutzer, period, heatmap_metric, Filter) gecacht.

GET/api/v1/insights

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Query-Parameter

period

string

Steuert das Zeitfenster der gesamten Seite, Standard 7d. Ein nicht erkannter Wert liefert 400.

7d30dytdall

Example: "30d"

heatmap_metric

string

Welche Metrik die Jahres-Heatmap anzeigt (die Heatmap ist immer ein volles Kalenderjahr, unabhängig von period), Standard spend. Ein nicht erkannter Wert liefert 400.

spendtokensrequests

Example: "tokens"

model

string

Seitenweiter Filter — zählt nur Nutzung für dieses Modell. Weggelassen bedeutet ungefiltert.

api_key_id

string

Seitenweiter Filter — zählt nur Nutzung für diesen API-Schlüssel. Weggelassen bedeutet ungefiltert.

app

string

Seitenweiter Filter — zählt nur Nutzung, die mit diesem App-Namen (x-title / HTTP-Referer) getaggt ist. Weggelassen bedeutet ungefiltert.

GET /api/v1/insights

1
2
curl "https://bazaarlink.ai/api/v1/insights?period=30d&heatmap_metric=tokens" \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

Antwortbeispiele

Erfolg. trend/topModels/heatmap liefern immer die vollständigen Daten für alle drei Metriken (tokens, spend, requests), sodass der Frontend-Umschalter keinen erneuten Abruf benötigt; caching und breakdown werden nach period gebündelt (täglich ≤120 Tage, wöchentlich ≤730 Tage, sonst monatlich). Das folgende Beispiel ist gekürzt — die echten buckets-/heatmap.days-Arrays enthalten je nach Periodenlänge viele Einträge.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
{
  "period": "30d",
  "bucketUnit": "day",
  "trend": {
    "tokens": {
      "total": 152000,
      "prevTotal": 98000,
      "changePct": 55.1,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 5200
            }
          ]
        }
      ]
    },
    "spend": {
      "total": 4.82,
      "prevTotal": 3.1,
      "changePct": 55.5,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 0.16
            }
          ]
        }
      ]
    },
    "requests": {
      "total": 340,
      "prevTotal": 210,
      "changePct": 61.9,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 12
            }
          ]
        }
      ]
    }
  },
  "topModels": {
    "tokens": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 152000,
        "unit": "tokens"
      }
    ],
    "spend": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 4.82,
        "unit": "spend"
      }
    ],
    "requests": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 340,
        "unit": "requests"
      }
    ]
  },
  "caching": {
    "buckets": [
      {
        "date": "2026-07-01",
        "hit": 3200,
        "write": 800
      }
    ],
    "totalHit": 96000,
    "totalWrite": 24000
  },
  "breakdown": {
    "buckets": [
      {
        "date": "2026-07-01",
        "prompt": 4000,
        "completion": 1200,
        "reasoning": 0,
        "cached": 3200
      }
    ],
    "totals": {
      "prompt": 120000,
      "completion": 32000,
      "reasoning": 0,
      "cached": 96000
    }
  },
  "heatmap": {
    "spend": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 0.02
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 0.16,
      "avgWeek": 1.12,
      "total": 58.4
    },
    "tokens": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 640
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 5066,
      "avgWeek": 35462,
      "total": 1850000
    },
    "requests": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 4
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 11.3,
      "avgWeek": 79,
      "total": 4130
    }
  },
  "credit": {
    "today": 0.16,
    "thisWeek": 1.12,
    "thisMonth": 4.82
  },
  "freeModel": {
    "today": 0,
    "thisWeek": 0,
    "thisMonth": 0
  },
  "facets": {
    "models": [
      "openai/gpt-4.1"
    ],
    "apiKeys": [
      {
        "id": "key_abc123",
        "name": "default"
      }
    ],
    "apps": [
      "my-app"
    ]
  }
}