Créditos

Solicitud	Créditos
Consulta en vivo: el endpoint consulta la fuente cuando lo llamas	10
Solicitud a datasets: el endpoint responde desde una copia que Croma mantiene al día	1

Solicitud

Créditos

Consulta en vivo: el endpoint consulta la fuente cuando lo llamas

Solicitud a datasets: el endpoint responde desde una copia que Croma mantiene al día

Qué no consume nada

Una respuesta desde caché (X-Cache: HIT, o cache_hit: true en un elemento de un lote), aunque la solicitud necesita créditos suficientes para ser aceptada.

Una solicitud fallida.

Consultar el estado de un job.

Las solicitudes en lote consumen créditos por elemento: un lote de 10 consultas en vivo consume 100.

Tu saldo en cada respuesta

Tres encabezados llevan el saldo. X-RateLimit-Limit son los créditos que tu plan otorga cada mes, X-RateLimit-Remaining es lo que queda después de esta solicitud y X-RateLimit-Reset es cuándo se renueva el saldo:

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4990
X-RateLimit-Reset: 2026-10-01T00:00:00.000Z

El saldo se reinicia en la fecha mensual del plan. Administra el plan desde la consola. Los contratos tienen su propio número mensual.

Cuando se agotan los créditos

Una solicitud que tus créditos restantes no cubren devuelve 402 con un sobre billing_error. Mejora el plan desde la consola o espera el reinicio que indica X-RateLimit-Reset:

{
  "error": {
    "type": "billing_error",
    "code": "plan_limit_reached",
    "message": "Your plan has no credits left for this period. Upgrade at https://platform.usecroma.com/billing or wait until 2026-10-01T00:00:00.000Z."
  }
}

Siguiente: Límites de tasa

Los topes por hora de algunos endpoints, todos los encabezados y cómo se comporta un 429.

Primeros pasos

Tipos de solicitud

Países

Qué no consume nada

Tu saldo en cada respuesta

Cuando se agotan los créditos

Siguiente: Límites de tasa

​Qué no consume nada

​Tu saldo en cada respuesta

​Cuando se agotan los créditos

Siguiente: Límites de tasa

Qué no consume nada

Tu saldo en cada respuesta

Cuando se agotan los créditos