Nutzungsstatistiken

Zeigen Sie API-Nutzungsstatistiken für Ihr Konto an, einschließlich Anfrageanzahl, Rate-Limit-Status und aktiven 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.

Authentifizierung

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

Beispielanfragen

cURL


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

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/account/usage',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
 
console.log(`Today: ${data.requests.today} requests`);
console.log(`This week: ${data.requests.this_week} requests`);
console.log(`This month: ${data.requests.this_month} requests`);
console.log(`Rate limit remaining: ${data.requests.limit.remaining}/${data.requests.limit.per_minute} per minute`);
console.log(`Active streams: ${data.streams.active}/${data.streams.max}`);

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/account/usage',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
usage = response.json()['data']
 
print(f"Today: {usage['requests']['today']} requests")
print(f"This month: {usage['requests']['this_month']} requests")
print(f"Rate limit: {usage['requests']['limit']['remaining']}/{usage['requests']['limit']['per_minute']} per minute")
print(f"Active streams: {usage['streams']['active']}/{usage['streams']['max']}")

Antwort

Erfolg (200)


{
  "data": {
    "requests": {
      "today": 342,
      "this_week": 2105,
      "this_month": 14523,
      "limit": {
        "per_minute": 300,
        "remaining": 287,
        "resets_at": "2026-02-08T14:45:00.000Z"
      }
    },
    "streams": {
      "active": 2,
      "max": 10
    },
    "period": {
      "start": "2026-02-01T00:00:00.000Z",
      "end": "2026-02-28T23:59:59.000Z"
    }
  },
  "meta": {
    "updated_at": "2026-02-08T14:50:00.123Z"
  }
}

Antwort-Header


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

Fehlerantworten

401 Unauthorized


{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

Antwortfelder

Requests-Objekt

Feld	Typ	Beschreibung
`today`	number	Gesamtzahl der API-Anfragen heute (UTC)
`this_week`	number	Gesamtzahl der API-Anfragen diese Woche
`this_month`	number	Gesamtzahl der API-Anfragen in diesem Abrechnungsmonat

Requests-Limit-Objekt

Feld	Typ	Beschreibung
`per_minute`	number	Maximal zulässige API-Anfragen pro Minute
`remaining`	number	Verbleibende Anfragen im aktuellen Rate-Limit-Fenster
`resets_at`	string	ISO-8601-Zeitstempel, wann das Rate-Limit-Fenster zurückgesetzt wird

Streams-Objekt

Feld	Typ	Beschreibung
`active`	number	Anzahl der aktuell aktiven SSE-/WebSocket-Streams
`max`	number	Maximal zulässige gleichzeitige Streams (0, wenn Streaming nicht aktiviert ist)

Period-Objekt

Feld	Typ	Beschreibung
`start`	string	ISO-8601-Beginn des aktuellen Abrechnungsmonats
`end`	string	ISO-8601-Ende des aktuellen Abrechnungsmonats

Anwendungsfälle

Rate-Limit-Nutzung überwachen


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/account/usage',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
usage = response.json()['data']
 
limit = usage['requests']['limit']
usage_pct = (1 - limit['remaining'] / limit['per_minute']) * 100
print(f"Rate limit usage: {usage_pct:.1f}%")
print(f"Resets at: {limit['resets_at']}")

Stream-Verfügbarkeit prüfen


const { data } = await fetch(
  'https://api.sharpapi.io/api/v1/account/usage',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
).then(r => r.json());
 
if (data.streams.active >= data.streams.max) {
  console.log('All stream slots in use — close a stream before opening a new one');
} else {
  console.log(`${data.streams.max - data.streams.active} stream slots available`);
}