Estadísticas de uso
Consulta cuántas solicitudes ha hecho tu clave hasta ahora hoy (día UTC), su ventana actual de rate limit (solicitudes restantes en este minuto y cuándo se reinicia la ventana) y el número de streams abiertos.
GET /api/v1/account/usageEste endpoint reemplaza al antiguo endpoint /me/usage. El formato de la respuesta se ha actualizado para utilizar el envoltorio estándar v1.
AutenticaciónEnlace permanente a esta sección
Requiere API key. Disponible para todos los planes.
Ejemplos de solicitudesEnlace permanente a esta sección
cURL
curl -X GET "https://api.sharpapi.io/api/v1/account/usage" \
-H "X-API-Key: YOUR_API_KEY"RespuestaEnlace permanente a esta sección
Éxito (200)Enlace permanente a esta sección
{
"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 es el número de solicitudes hechas con esta clave hasta ahora en el día UTC actual. Vuelve a 0 a las 00:00 UTC. Una solicitud se cuenta cada vez que pasa por el limitador de tasa, incluidas las que el limitador rechaza con 429. El 19 de octubre de 2026 el recuento comenzó cuando este campo entró en servicio, por lo que la cifra de ese día es menor que el total real.
rate_limit.limit, rate_limit.remaining y rate_limit.reset describen la ventana de rate limit de un minuto, que es independiente, y no el recuento diario.
Cabeceras de respuestaEnlace permanente a esta sección
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1770562200
X-Data-Delay: 0
X-Request-Id: req_usage789abcRespuestas de errorEnlace permanente a esta sección
401 Unauthorized
Si no se envía ninguna clave se devuelve missing_api_key; una clave inválida devuelve 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"
}
}Campos de la respuestaEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
requests_today | integer | Solicitudes hechas con esta clave hasta ahora en el día UTC actual. Se reinicia a las 00:00 UTC. Se cuenta toda solicitud que pasa por el limitador de tasa, incluidas las rechazadas con 429. No se informa ningún total semanal ni mensual. |
rate_limit | object | La ventana actual de rate limit de un minuto (ver más abajo) |
active_streams | integer | Conexiones de streaming actualmente abiertas con esta clave |
El envoltorio también incluye un updated_at de nivel superior (marca de tiempo RFC 3339).
Objeto Rate LimitEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
limit | integer | Solicitudes permitidas por minuto en tu plan |
remaining | integer | Solicitudes restantes en el minuto actual (limit menos las solicitudes ya contadas en este minuto, nunca por debajo de 0). Independiente de requests_today |
reset | integer | Marca de tiempo Unix (en segundos) en la que termina la ventana actual de un minuto |
Casos de usoEnlace permanente a esta sección
Monitorizar el uso del rate limitEnlace permanente a esta sección
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()}")Seguimiento de las solicitudes diariasEnlace permanente a esta sección
requests_today es una cifra diaria; usa rate_limit para el ritmo por minuto. Este ejemplo compara el recuento diario con un presupuesto que eliges tú (la respuesta no incluye un límite diario):
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}%)")Comprobar los streams abiertosEnlace permanente a esta sección
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`);La respuesta no incluye el límite de streams concurrentes de tu plan; consulta Precios para ver los límites de cada plan.
Endpoints relacionadosEnlace permanente a esta sección
- Información de la cuenta - Detalles de la cuenta, plan y características
- Gestión de API keys - Gestiona tus API keys
- Precios - Compara los límites de los planes