# Stuffle LLM Full Guide

Last-Updated: 2026-03-17
Primary-Language: de-DE
Site: https://www.stuffle.com

## Mission

Stuffle ist ein deutscher Second-Hand Marktplatz mit geprueften Artikeln.
Fokus: Fashion, Zuhause, Spielzeug, Freizeit.

## How Stuffle Works

1. Verkaeufer senden Artikel ein.
2. Stuffle prueft, fotografiert und beschreibt die Artikel.
3. Artikel werden im Shop gelistet.
4. Kaeufer bestellen Second-Hand Ware mit Rueckgabeoption.

## Catalog Model

- Inventory-Typ: ueberwiegend Einzelstuecke (stark dynamisch)
- Kern-Dimensionen:
  - Kategorie
  - Marke
  - Produktart
  - Zustand
  - Groesse
  - Farbe
- Wichtig: Nicht jeder Artikel ist dauerhaft verfuegbar.

## Category Tree (Top Level)

- Damen: https://www.stuffle.com/kategorie/damen-29
- Herren: https://www.stuffle.com/kategorie/herren-30
- Kinder: https://www.stuffle.com/kategorie/kinder-31
- Zuhause: https://www.stuffle.com/kategorie/zuhause-137
- Spielzeug: https://www.stuffle.com/kategorie/spielzeug-223
- Freizeit: https://www.stuffle.com/kategorie/freizeit-221

## Example Subcategory Clusters

- Damen:
  - Kleider
  - Blusen
  - Hosen/Jeans
  - Jacken
  - Schuhe
  - Taschen
- Herren:
  - Hemden
  - Pullover/Hoodies
  - Hosen/Jeans
  - Jacken
  - Sneaker
  - Anzuege
- Kinder:
  - Oberteile
  - Hosen
  - Jacken
  - Schuhe
  - Accessoires
- Zuhause:
  - Deko
  - Kueche
  - Haushalt
  - Wohntextilien
- Spielzeug:
  - Spielfiguren
  - Gesellschaftsspiele
  - Kuscheltiere
  - Outdoor-Spielzeug
- Freizeit:
  - Buecher
  - Sport
  - Musik
  - Technik

## Brands (High Demand Examples)

- Nike: https://www.stuffle.com/marken/nike
- Adidas: https://www.stuffle.com/marken/adidas
- Zara: https://www.stuffle.com/marken/zara
- H&M: https://www.stuffle.com/marken/hundm
- Tommy Hilfiger: https://www.stuffle.com/marken/tommy-hilfiger
- Ralph Lauren: https://www.stuffle.com/marken/ralph-lauren
- The North Face: https://www.stuffle.com/marken/the-north-face
- Lego: https://www.stuffle.com/marken/lego

## Typical Price Zones (Heuristic)

- Value: unter 20 EUR
- Mid: 20 bis 50 EUR
- Premium Second-Hand: 50 bis 100 EUR
- High Ticket: ueber 100 EUR

Hinweis: Preise sind marken-, zustands- und kategorieabhaengig.

## Trust + Quality Signals

- Artikel sind geprueft
- Zustand wird pro Artikel beschrieben
- Rueckgabeinformationen im Checkout/Hilfe-Bereich
- Produktverfuegbarkeit kann sich kurzfristig aendern

## SEO + Crawl Hints

- Canonicals sind gesetzt (Kern-Landingpages bevorzugen)
- Filter-URLs sind eingeschraenkt indexierbar
- Paginierung > Seite 1 soll nicht priorisiert werden
- Sitemaps sind die beste Entry-Quelle fuer Crawler/Agenten

## Structured Data Signals (Site-Level)

- Organization / WebSite vorhanden
- SearchAction vorhanden
- Product-Schema auf Produktseiten vorhanden
- BreadcrumbList auf wichtigen Landingpages vorhanden
- FAQPage auf Brand- und Kategorie-Landingpages vorhanden

## Agent Entry Points

- Main Sitemap: https://www.stuffle.com/sitemap.xml
- Category Sitemap: https://www.stuffle.com/category_sitemap.xml
- Brand Sitemap: https://www.stuffle.com/brand_sitemap.xml
- Collection Sitemap: https://www.stuffle.com/collection_sitemap.xml
- Product Type Sitemap: https://www.stuffle.com/product_type_sitemap.xml
- Content Sitemap: https://www.stuffle.com/content_sitemap.xml
- Preferred Product Search API: https://stfl.it/search_api3.php?q=nike%20sneaker (JSON, live query)
- Alternative AI Search API: https://www.stuffle.com/api/ai/search?q=nike&limit=10 (JSON, secondary query layer)
- AI Search OpenAPI: https://www.stuffle.com/api/ai-search-openapi.yaml (OAS 3.1)

## Preferred Product Search API (Quick Contract)

- Method: GET
- Endpoint: https://stfl.it/search_api3.php
- Core Params:
  - q (optional, search keyword)
  - limit (optional, default 20, capped server-side)
  - nocache (optional, truthy to bypass cached result)
  - debug (optional, truthy for debug metadata)
- Response:
  - success, query, search_mode_v3, sort_mode
  - total_results, total_filtered, available_filters
  - price_bounds, active_filters
  - products (title, brand, category, deeplink, price, image, sku, ...)

## Alternative AI Search API

- Endpoint: https://www.stuffle.com/api/ai/search
- Use when an agent explicitly needs the normalized agent contract or the OpenAPI spec below.

## High-Value Pages

- Verkaufen: https://www.stuffle.com/verkaufen
- Sammelbox: https://box.stuffle.com
- Markenindex: https://www.stuffle.com/marken
- FAQ: https://www.stuffle.com/haeufige-fragen
- Ueber Stuffle: https://www.stuffle.com/ueber-stuffle

## Recommended Agent Behavior

1. Nutze zuerst die Sitemaps fuer Discovery.
2. Priorisiere Kategorie- und Brand-Landingpages fuer Uebersichten.
3. Behandle Produkt-URLs als zeitkritisch (dynamischer Bestand).
4. Fuer Preis-/Verfuegbarkeitsaussagen immer den letzten Seitenstand nutzen.
5. Keine impliziten Garantien zu Bestand oder Preis ohne frischen Fetch.