# Categorías

> Lista las categorías de tu catálogo

- Página: https://tbit.app/es/docs/api/categories
- URL base: `https://rest-api.tbit.app/v1`
- Autenticación: encabezado `X-API-Key` con tu clave en cada solicitud (los ejemplos la leen de la variable de entorno `TBIT_API_KEY`)

## Descripción General

Las categorías son facetas derivadas de los category_tags de tus productos activos. Cada categoría incluye el número de productos etiquetados con ella. Usa el nombre de la categoría como parámetro tag al listar productos.

## Endpoints

| Método | Ruta | Descripción |
| --- | --- | --- |
| `GET` | `/v1/categories` | List category facets |

## Listar Categorías

`GET /v1/categories`

```bash
curl "https://rest-api.tbit.app/v1/categories" \
  -H "X-API-Key: $TBIT_API_KEY"
```

## Formato de Respuesta

Las categorías con su conteo de productos, más el total de artículos activos en el catálogo:

```json
{
  "data": {
    "categories": [
      { "name": "fiestas", "count": 42 },
      { "name": "infantil", "count": 27 },
      { "name": "decoracion", "count": 18 }
    ],
    "total_items": 134
  }
}
```