Skip to Content
Referencia de la APIEstadísticas de uso

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/usage

Este 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 -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_usage789abc

Respuestas 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

CampoTipoDescripción
requests_todayintegerSolicitudes 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_limitobjectLa ventana actual de rate limit de un minuto (ver más abajo)
active_streamsintegerConexiones 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

CampoTipoDescripción
limitintegerSolicitudes permitidas por minuto en tu plan
remainingintegerSolicitudes restantes en el minuto actual (limit menos las solicitudes ya contadas en este minuto, nunca por debajo de 0). Independiente de requests_today
resetintegerMarca 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

Last updated on