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/usageDieser 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
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_usage789abcFehlerantwortenPermalink 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
| Feld | Typ | Beschreibung |
|---|---|---|
requests_today | integer | Mit 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_limit | object | Das aktuelle Rate-Limit-Fenster von einer Minute — siehe unten |
active_streams | integer | Aktuell 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
| Feld | Typ | Beschreibung |
|---|---|---|
limit | integer | Pro Minute erlaubte Anfragen in Ihrem Tarif |
remaining | integer | In der aktuellen Minute verbleibende Anfragen (limit minus der in dieser Minute bereits gezählten Anfragen, nie unter 0). Unabhängig von requests_today |
reset | integer | Unix-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
- Kontoinformationen - Kontodetails, Tarif und Funktionen
- API-Schlüsselverwaltung - Verwalten Sie Ihre API-Schlüssel
- Preise - Tarifgrenzen vergleichen