> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suchergebnisse abrufen

> Fragen Sie den Kameleoon Search-Service ab, um sofortige oder vollständige Produktsuchergebnisse basierend auf Benutzereingaben abzurufen.

Der Kameleoon Search-Service bietet zwei Suchtypen:

* **Instant (typeahead) search**: Zeigt Ergebnisse an und aktualisiert sie, während Benutzer Suchanfragen eingeben.
* **Full search**: Gibt vollständige, gefilterte Suchergebnisse zurück, nachdem der Benutzer eine Suchanfrage abgesendet hat.

Beide Optionen verwenden denselben Endpoint. Verwenden Sie den Parameter `type`, um den Suchtyp anzugeben.

### Anfrage

```
GET https://api.products.kameleoon.com/search
```

### Abfrageparameter

Diese Abfrageparameter gelten sowohl für die Full Search als auch für die Instant Search. Verwenden Sie [zusätzliche Parameter](#zusätzliche-abfrageparameter-nur-full-search) nur mit der Full Search.

| Parameter      | Typ    | Erforderlich | Beschreibung                                                                                                                                                                                                                                                                                                                                         |
| :------------- | :----- | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `did`          | String | True         | Device-ID. Holen Sie diese ID aus dem Cookie `KameleoonProducts_device_id`. Rufen Sie sie vor dem Aufruf dieses Endpoints aus dem Backend ab. Geben Sie `did` nur an, wenn Sie Filter oder Algorithmen verwenden, die auf historischen Gerätedaten basieren, wie zum Beispiel "Recently Viewed" oder "Recommended for You."                          |
| `sid`          | String | True         | Temporäre Benutzersitzungs-ID. Holen Sie diese ID aus dem Cookie `KameleoonProducts_session_code`. Rufen Sie sie vor dem Aufruf dieses Endpoints aus dem Backend ab. Geben Sie `sid` nur an, wenn Sie Filter oder Algorithmen verwenden, die auf historischen Benutzerdaten basieren, wie zum Beispiel "Recently Viewed" oder "Recommended for You." |
| `shop_id`      | String | True         | Store Key. Sie finden ihn in **Recommendations** > **Settings** > **Store settings** in der Kameleoon App. Kontaktieren Sie Ihren Customer Success Manager, falls erforderlich, um den Schlüssel zu erhalten.                                                                                                                                        |
| `type`         | String | True         | Gibt den Suchtyp an: `instant_search` oder `full_search`.                                                                                                                                                                                                                                                                                            |
| `search_query` | String | True         | Aktuelle Suchanfrage.                                                                                                                                                                                                                                                                                                                                |
| `locations`    | List   | Optional     | Durch Kommas getrennte Liste von Standort-IDs.                                                                                                                                                                                                                                                                                                       |

### Zusätzliche Abfrageparameter (nur Full Search)

Verwenden Sie diese zusätzlichen Parameter mit Full Search-Anfragen (`type=full_search`).

| Parameter        | Typ              | Erforderlich | Beschreibung                                                                                                                                                                                                                                                                 |
| :--------------- | :--------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`          | Integer          | Optional     | Maximale Anzahl der von der API zurückgegebenen Ergebnisse.                                                                                                                                                                                                                  |
| `offset`         | Integer          | Optional     | Ergebnisversatz.                                                                                                                                                                                                                                                             |
| `category_limit` | Integer          | Optional     | Maximale Anzahl von Kategorien für den Sidebar-Filter.                                                                                                                                                                                                                       |
| `categories`     | List             | Optional     | Durch Kommas getrennte Liste von Kategorien zur Filterung.                                                                                                                                                                                                                   |
| `extended`       | Integer or empty | Optional     | Fügt erweiterte Informationen für Produktergebnisse hinzu. Unterstützte Werte: `1` oder leer. Bei `1` gibt die API alle Produktinformationen zurück. Wenn leer, gibt die API nur Produkt-IDs zurück. Kameleoon empfiehlt, diesen Wert für die Full Search auf `1` zu setzen. |
| `sort_by`        | String           | Optional     | Sortierparameter. Unterstützte Werte: `popular`, `price`, `discount`, `sales_rate`, `date`.                                                                                                                                                                                  |
| `order`          | String           | Optional     | Sortierrichtung: `asc` (aufsteigend) oder `desc` (absteigend). Standardwert ist `desc`.                                                                                                                                                                                      |
| `brands`         | List             | Optional     | Durch Kommas getrennte Liste von Marken zur Filterung.                                                                                                                                                                                                                       |
| `filters`        | String           | Optional     | Escapeter JSON-String mit Filterparametern. Beispiel: `{"bluetooth":["yes"],"offers":["15% cashback"],"weight":["1.6"]}`                                                                                                                                                     |
| `price_min`      | Integer          | Optional     | Mindestpreis.                                                                                                                                                                                                                                                                |
| `price_max`      | Integer          | Optional     | Höchstpreis.                                                                                                                                                                                                                                                                 |
| `colors`         | Integer          | Optional     | Durch Kommas getrennte Liste der Farben.                                                                                                                                                                                                                                     |
| `exclude`        | Integer          | Optional     | Durch Kommas getrennte Liste von Produkt-IDs, die aus den Suchergebnissen ausgeschlossen werden sollen.                                                                                                                                                                      |

### Antwort (Instant Search)

| Name                     | Typ    | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| :----------------------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_query`           | string | Suchanfrage.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `categories`             | array  | Kategorieinformationen. Jedes Objekt enthält diese Eigenschaften:<ul><li>`id` – Kategorie-ID (string)</li><li>`name` – Kategoriename (string)</li><li>`url` – Kategorie-URL (string)</li><li>`count` – Anzahl der Produkte in der Kategorie (number)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `filters`                | array  | Filterinformationen. Jedes Objekt enthält diese Eigenschaften: <ul><li>`filter` – Filterobjekt mit diesen Eigenschaften:</li><li>`count` – Gesamtanzahl der Produkte, die diesen Parametern entsprechen (number)</li><li>`values` – Array von Werteobjekten mit diesen Eigenschaften:</li><li>`value` – Wertlabel (string)</li><li>`count` – Anzahl der Produkte mit diesem Parameter (number)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `html`                   | string | HTML-Code für den Produktblock. Passen Sie die Vorlage im persönlichen Kameleoon-Konto an.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `price_range`            | object | Mindest- und Höchstpreise der Produkte. Enthält diese Eigenschaften:<ul><li>`min` – Mindestpreis (number)</li><li>`max` – Höchstpreis (number)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `products`               | array  | Produktinformationen. Jedes Objekt enthält diese Eigenschaften:<ul><li>`description` – Produktbeschreibung (string)</li><li>`url` – absolute Produkt-URL (string)</li><li>`url_handle` – relative Produkt-URL (string)</li><li>`picture` – URL des Produktbildes im Kameleoon-Speicher (string)</li><li>`name` – Produktname (string)</li><li>`price` – Produktpreis (integer)</li><li>`price_full` – Produktpreis (float)</li><li>`price_formatted` – Produktpreis mit Währung (string)</li><li>`price_full_formatted` – formatierter Produktpreis mit Währung (string)</li><li>`image_url` - absolute URL des Produktbildes im Kameleoon-Speicher (string)</li><li>`image_url_handle` - relative URL des Produktbildes im Kameleoon-Speicher (string)</li><li>`image_url_resized` - Array von skalierten Bild-URLs</li><li>`currency` – Produktwährung (string)</li><li>`id` – Produkt-ID (string)</li><li>`old_price` – alter Produktpreis (integer, Standard ist 0)</li><li>`old_price_full` – alter Produktpreis (float)</li><li>`old_price_formatted` – alter Produktpreis mit Währung (string)</li><li>`old_price_full_formatted` – formatierter alter Produktpreis mit Währung (string)</li><li>Zusätzliche Eigenschaften, wenn Sie `extended` in die Anfrage aufnehmen:<ul><li>`id` – Kategorie-ID (string)</li><li>`name` – Kategoriename (string)</li><li>`parent_id` – ID der übergeordneten Kategorie (string)</li><li>`url` - Kategorie-URL</li><li>`category_ids` - Produktkategorie-IDs (array)</li></ul></li></ul> |
| `search_query_redirects` | array  | Weiterleitungsinformationen. Jedes Objekt enthält diese Eigenschaften:<ul><li>`query` – Suchanfrage (string)</li><li>`redirect_link` – URL für die Weiterleitung (string)</li><li>`deep_link` – URL für mobile Anwendungen (string)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `products_total`         | number | Gesamtanzahl der Produkte.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

### Antwort (Full Search)

| Name             | Typ    | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| :--------------- | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `brands`         | array  | Markeninformationen. Jedes Objekt enthält diese Eigenschaften:<ul><li>`name` – Markenname (string)</li><li>`picture` – URL des Markenbildes (string)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `categories`     | array  | Kategorieinformationen. Jedes Objekt enthält diese Eigenschaften:<ul><li>`alias` – Kategoriealias (string)</li><li>`id` – Kategorie-ID (string)</li><li>`name` – Kategoriename (string)</li><li>`parent` – ID der übergeordneten Kategorie (string)</li><li>`url` – Kategorie-URL (string)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `filters`        | array  | Filterinformationen. Jedes Objekt enthält diese Eigenschaften:<ul><li>`filter` – Filterobjekt mit diesen Eigenschaften:<ul><li>`count` – Gesamtanzahl der Produkte, die diesen Parametern entsprechen (number)</li><li>`values` – Werteobjekte mit `value` (string) und `count` (number)</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `html`           | string | HTML-Code für den Produktblock. Passen Sie die Vorlage im persönlichen Kameleoon-Konto an.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `price_range`    | object | Mindest- und Höchstpreise der Produkte. Enthält diese Eigenschaften:<ul><li>`min` – Mindestpreis (number)</li><li>`max` – Höchstpreis (number)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `products`       | array  | Produktinformationen. Jedes Objekt enthält diese Eigenschaften:<ul><li>`brand` – Produktmarke (string)</li><li>`currency` – Produktwährung (string)</li><li>`id` – Produkt-ID (string)</li><li>`is_new` – Produkteigenschaft (boolean, Standard ist null)</li><li>`name` – Produktname (string)</li><li>`old_price` – alter Produktpreis (string, Standard ist 0)</li><li>`picture` – URL des Produktbildes im Kameleoon-Speicher (string)</li><li>`price` – Produktpreis (number)</li><li>`price_formatted` – Produktpreis mit Währung (string)</li><li>`url` – Produkt-URL (string)</li><li>Zusätzliche Eigenschaften, wenn Sie `extended` in die Anfrage aufnehmen:<ul><li>`barcode` – Produkt-Barcode (string)</li></ul></li><li>`categories` – Produktkategorien (array) mit `id`, `name` und `parent`-ID.</li><li>`params` – Parameterinformationen. Jedes Objekt enthält `key` (string) und `values` (array).</li></ul> |
| `products_total` | number | Gesamtanzahl der Produkte.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `search_query`   | string | Suchanfrage.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |