# Acceso y cuotas

> Bazar es abierto con una cuota diaria por IP; una API key da una cuota por minuto propia.

URL: https://boelabs.com/docs/bazar/acceso
Language: Español

## Sin API key

Bazar es abierto: sin API key, cada dirección IP puede hacer **5 consultas por segundo, 10 por
minuto y 30 al día** (el día en hora UTC). Entre todos los usuarios sin key hay además un total de
1.000 consultas al día; si se agota, el acceso sin key se cierra hasta medianoche UTC.

Cuenta cada petición a `/v1` y cada llamada a herramienta en `/mcp`; conectarse y listar las
herramientas no cuenta.

```bash
curl "https://bazar.boelabs.com/v1/stores"
```

## Con API key

Para un uso mayor, o desde un servidor que comparte su IP, usa una API key. Tiene su propia cuota
por minuto y no gasta las cuotas sin key:

```bash
curl -H "Authorization: Bearer bz_…" "https://bazar.boelabs.com/v1/stores"
```

Una key mal escrita, desconocida o revocada responde `401`; nunca se trata como acceso anónimo.

- **Pedirla:** las keys las crea el equipo de Bazar, una por consumidor; pídela por el canal de
  soporte de [Boelabs](https://boelabs.com).
- **Guardarla:** la key se muestra una sola vez. Guárdala como un secreto, del lado del servidor,
  nunca en un frontend.
- **La misma key** sirve para REST y para MCP, y gasta una sola cuota.
- **Rotarla:** se crea una nueva y se revoca la vieja. Una key revocada deja de funcionar en menos
  de un minuto.

<Callout type="warn" title="Nunca en el navegador">
  Una key en el código de un frontend es una key pública. Llama a Bazar desde tu servidor.
</Callout>

## Cuánto queda

Cada respuesta con cuota trae `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset`
(segundos hasta que se renueva la ventana). Al agotarse, la respuesta es `429 RATE_LIMITED` con
`Retry-After`: espera esos segundos antes de reintentar.

`/health`, la [referencia OpenAPI](https://bazar.boelabs.com/docs) y
[`/llms.txt`](https://bazar.boelabs.com/llms.txt) son públicos y no gastan cuota.

## Límites

| Qué                         | Límite                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Peticiones sin key          | 5 por segundo, 10 por minuto y 30 al día por IP; 1.000 al día entre todos.                                          |
| Peticiones por key          | 120 por minuto por defecto (se puede pedir otro valor), en ventanas de un minuto. REST y MCP gastan la misma cuota. |
| Resultados por página       | `limit` de 1 a 50 (búsqueda y sucursales, 10 por defecto; comparación, 20).                                         |
| Profundidad de una búsqueda | 300 resultados ordenados.                                                                                           |
| `q`                         | 200 caracteres.                                                                                                     |
| `stores`                    | 20 tiendas por búsqueda.                                                                                            |
| Historial                   | 730 días.                                                                                                           |
| Radio                       | 200 km.                                                                                                             |