Skip to Content
API-ReferenzNutzungsstatistiken

Nutzungsstatistiken

Zeigen Sie an, wie viele Anfragen Ihr Schlüssel heute (UTC-Tag) bisher gestellt hat, sowie das aktuelle Rate-Limit-Fenster — in dieser Minute verbleibende Anfragen und den Zeitpunkt des Zurücksetzens — und die Anzahl der offenen Streams.

GET /api/v1/account/usage

Dieser Endpoint ersetzt den früheren /me/usage-Endpoint. Das Antwortformat wurde aktualisiert und verwendet nun den standardmäßigen v1-Envelope.

AuthentifizierungPermalink zu diesem Abschnitt

Erfordert einen API-Schlüssel. Verfügbar in allen Tarifen.

BeispielanfragenPermalink zu diesem Abschnitt

curl -X GET "https://api.sharpapi.io/api/v1/account/usage" \ -H "X-API-Key: YOUR_API_KEY"

AntwortPermalink zu diesem Abschnitt

Erfolg (200)Permalink zu diesem Abschnitt

{ "data": { "active_streams": 2, "rate_limit": { "limit": 300, "remaining": 287, "reset": 1770562200 }, "requests_today": 1284 }, "updated_at": "2026-02-08T14:49:12.123Z" }

requests_today ist die Anzahl der Anfragen, die mit diesem Schlüssel im aktuellen UTC-Tag bisher gestellt wurden. Der Wert wird um 00:00 UTC auf 0 zurückgesetzt. Eine Anfrage wird jedes Mal gezählt, wenn sie den Rate Limiter passiert, auch Anfragen, die der Limiter mit 429 ablehnt. Am 19. Oktober 2026 begann die Zählung mit dem Start dieses Feldes, daher liegt der Wert dieses Tages unter der tatsächlichen Gesamtzahl.

rate_limit.limit, rate_limit.remaining und rate_limit.reset beschreiben das davon getrennte Rate-Limit-Fenster von einer Minute, nicht die Tageszählung.

Antwort-HeaderPermalink zu diesem Abschnitt

X-RateLimit-Limit: 300 X-RateLimit-Remaining: 287 X-RateLimit-Reset: 1770562200 X-Data-Delay: 0 X-Request-Id: req_usage789abc

FehlerantwortenPermalink zu diesem Abschnitt

401 Unauthorized

Ohne Schlüssel wird missing_api_key zurückgegeben; ein ungültiger Schlüssel ergibt invalid_api_key.

{ "error": { "code": "missing_api_key", "message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.", "docs": "https://docs.sharpapi.io/en/authentication" } }

AntwortfelderPermalink zu diesem Abschnitt

FeldTypBeschreibung
requests_todayintegerMit diesem Schlüssel im aktuellen UTC-Tag bisher gestellte Anfragen. Wird um 00:00 UTC zurückgesetzt. Jede Anfrage, die den Rate Limiter passiert, wird gezählt, auch mit 429 abgelehnte. Eine Wochen- oder Monatssumme wird nicht gemeldet.
rate_limitobjectDas aktuelle Rate-Limit-Fenster von einer Minute — siehe unten
active_streamsintegerAktuell auf diesem Schlüssel geöffnete Streaming-Verbindungen

Der Envelope enthält zusätzlich ein updated_at auf oberster Ebene (RFC-3339-Zeitstempel).

Rate-Limit-ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
limitintegerPro Minute erlaubte Anfragen in Ihrem Tarif
remainingintegerIn der aktuellen Minute verbleibende Anfragen (limit minus der in dieser Minute bereits gezählten Anfragen, nie unter 0). Unabhängig von requests_today
resetintegerUnix-Zeitstempel (Sekunden), zu dem das aktuelle Fenster von einer Minute endet

AnwendungsfällePermalink zu diesem Abschnitt

Rate-Limit-Nutzung überwachenPermalink zu diesem Abschnitt

from datetime import datetime, timezone import requests response = requests.get( 'https://api.sharpapi.io/api/v1/account/usage', headers={'X-API-Key': 'YOUR_API_KEY'} ) usage = response.json()['data'] rl = usage['rate_limit'] usage_pct = (1 - rl['remaining'] / rl['limit']) * 100 print(f"Rate limit used this minute: {usage_pct:.1f}%") print(f"Window resets at: {datetime.fromtimestamp(rl['reset'], tz=timezone.utc).isoformat()}")

Tägliche Anfragen verfolgenPermalink zu diesem Abschnitt

requests_today ist ein Tageswert; verwenden Sie rate_limit für das Tempo pro Minute. Dieses Beispiel vergleicht die Tageszählung mit einem selbst gewählten Budget (die Antwort enthält kein Tageslimit):

import requests DAILY_BUDGET = 50_000 # your own target; the API does not report a daily cap response = requests.get( 'https://api.sharpapi.io/api/v1/account/usage', headers={'X-API-Key': 'YOUR_API_KEY'} ) usage = response.json()['data'] used = usage['requests_today'] print(f"Requests today (UTC): {used} of {DAILY_BUDGET} ({used / DAILY_BUDGET * 100:.1f}%)")

Offene Streams prüfenPermalink zu diesem Abschnitt

const { data } = await fetch( 'https://api.sharpapi.io/api/v1/account/usage', { headers: { 'X-API-Key': 'YOUR_API_KEY' } } ).then(r => r.json()); console.log(`${data.active_streams} stream(s) open on this key`);

Die Antwort enthält nicht das Limit gleichzeitiger Streams Ihres Tarifs; die Limits je Tarif finden Sie unter Preise.

Verwandte EndpointsPermalink zu diesem Abschnitt

Last updated on