# Kategorien

> Die Kategorien deines Katalogs auflisten

- Seite: https://tbit.app/de/docs/api/categories
- Basis-URL: `https://rest-api.tbit.app/v1`
- Authentifizierung: Header `X-API-Key` mit deinem Schlüssel in jeder Anfrage (die Beispiele lesen ihn aus der Umgebungsvariable `TBIT_API_KEY`)

## Überblick

Kategorien sind Facetten, die aus den category_tags deiner aktiven Produkte abgeleitet werden. Jede Kategorie enthält die Anzahl der Produkte, die damit gelabelt sind. Nutze den Kategorienamen als Parameter tag, wenn du Produkte auflistest.

## Endpoints

| Methode | Pfad | Beschreibung |
| --- | --- | --- |
| `GET` | `/v1/categories` | Kategorie-Facetten auflisten |

## Kategorien auflisten

`GET /v1/categories`

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

## Antwortformat

Die Kategorien mit ihrer Produktanzahl, plus die Gesamtzahl aktiver Artikel im Katalog:

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