Vinted API: Second-Hand-Angebote von vinted.de mit Preis, Größe und Zustand

Einen offiziellen Zugang, über den sich der Vinted-Katalog per Code abfragen ließe, gibt es nicht. Diese API liest vinted.de so, wie die Seite ohne Anmeldung aussieht, und gibt Titel, Marke, Größe, Zustand, Fotos und Preis jedes Angebots als JSON zurück. Der Preis kommt doppelt: einmal so, wie er im Inserat steht, und einmal als Gesamtbetrag inklusive Käuferschutz-Gebühr. Versandkosten stecken in keinem der beiden Werte. Für Vinted-Pro-Händler, die Artikel hochladen oder Bestellungen abwickeln wollen, ist das die falsche Schnittstelle: Hier wird nur gelesen, was öffentlich auf vinted.de steht.

Funktionierendes Beispiel

Die Käuferschutz-Gebühr war bei allen 40 Artikeln, die wir am 26. Oktober abgefragt haben (20 aus dieser Suche, 20 mit dem Markenfilter Zara), genau 0,70 € plus 5 % des Artikelpreises: 0,90 € auf eine Jacke für 4 €, 3,70 € auf eine für 60 €. Wer Preise mit anderen Plattformen vergleicht, nimmt deshalb `total_item_price`; wer den Preis aus dem Inserat braucht, `price`. Bei „Lederjacke“ meldete Vinted 960 Treffer, das ist zugleich die Obergrenze pro Filterkombination.

curl -X POST https://api.reefapi.com/vinted/v1/catalog_search \
  -H "x-api-key: IHR_SCHLUESSEL" \
  -H "content-type: application/json" \
  -d '{"query": "Lederjacke", "tld": "de", "per_page": 20, "order": "newest_first"}'

{
  "ok": true,
  "data": {
    "items": [
      ...
      {
        "id": 10540741771,
        "title": "Stradivarius Lederjacke Beige Bikerjacke Gr. L (fällt wie M aus)",
        "url": "/items/10540741771-stradivarius-lederjacke-beige-bikerjacke-gr-l-fallt-wie-m-aus",
        "price": { "amount": 10.0, "currency": "EUR" },
        "total_item_price": { "amount": 11.2, "currency": "EUR" },
        "service_fee": { "amount": 1.2, "currency": "EUR" },
        "brand": "Stradivarius",
        "size": "L",
        "condition": "Sehr gut",
        "uploaded_ts": null,
        "promoted": false,
        ...
      },
      {
        "id": 10540735123,
        "title": "Bikerjacke aus Schafleder",
        "price": { "amount": 50.0, "currency": "EUR" },
        "total_item_price": { "amount": 53.2, "currency": "EUR" },
        "service_fee": { "amount": 3.2, "currency": "EUR" },
        "brand": "OAKWOOD",
        "size": "M",
        "condition": "Gut",
        ...
      },
      {
        "id": 10540729932,
        "title": "Lederjacke NEU",
        "price": { "amount": 25.0, "currency": "EUR" },
        "total_item_price": { "amount": 26.95, "currency": "EUR" },
        "service_fee": { "amount": 1.95, "currency": "EUR" },
        "brand": "H&M",
        "size": "M",
        "condition": "Neu, mit Etikett",
        ...
      },
      ...
    ],
    "pagination": { "current_page": 1, "per_page": 20, "total_entries": 960, "total_pages": 48 },
    "tld": "de"
  },
  "meta": {
    "record_count": 20,
    "tld": "de",
    "total_entries": 960,
    "window_cap": 960,
    "warnings": ["source_fields_unavailable: uploaded_ts, seller.login, seller.profile_url, is_visible, stats_visible, view_count, is_reserved, ..."],
    "charged_credits": 2,
    "cache_hit": false,
    "mode": "live"
  }
}

Grenzen und ehrliche Hinweise

• Wir betreiben diese API ohne Beteiligung von Vinted: kein offizieller Zugang, keine Partnerschaft.
• Ohne `"tld": "de"` geht die Anfrage an vinted.fr, das ist der Standardwert.
• Fünf Hilfs-Endpunkte funktionieren derzeit nicht (gemessen am 26. Oktober 2026 auf vinted.de, je zwei bis drei Versuche, alle mit 0 Credits verbucht): `autocomplete` und `conditions` antworten mit UPSTREAM_HTTP, `catalog_filters` mit NOT_FOUND, `similar` mit TARGET_BLOCKED. `brand_search` antwortet zwar, übergeht aber den Suchbegriff: „stradivarius“, „jack wolfskin“ und „superdry“ ergaben dieselben 12 Marken. Deshalb stehen sie oben nicht in der Tabelle.
• Solange das so ist, lassen sich Zustands- und Material-ids nicht nachschlagen. `brand_ids` funktioniert mit ids, die man schon hat: 12 (Zara) lieferte 20 von 20 Zara-Artikeln.
• In `item_detail` fehlt die Größe zurzeit: `size` war bei allen drei geprüften Artikeln leer, und im Attribut „Größe“ stand der Text „Zustand“; ein eigenes Zustandsattribut fehlte. Größe und Zustand mit deutschen Bezeichnungen liefert verlässlich die Trefferzeile aus `catalog_search`; `item_detail` nennt den Zustand nur im schema.org-Format (`UsedCondition`, `NewCondition`), und `url` ist dort null.
• Pro Filterkombination gibt Vinted höchstens 960 Treffer heraus (`total_entries` bleibt bei 960). Wer mehr braucht, schneidet enger: nach Kategorie, Größe oder Preisspanne.
• Nicht jeder Treffer passt zum Suchbegriff: Unter den 20 neuesten für „Lederjacke“ waren eine Fellweste und ein Pullover.
• Versandkosten liefert kein Endpunkt. `total_item_price` enthält nur die Käuferschutz-Gebühr.
• In den Trefferzeilen von `catalog_search` sind Hochladezeitpunkt, Aufrufe und Statusfelder null (Liste in `meta.warnings`). Ob ein Artikel reserviert oder verkauft ist, zeigt `seller_items`, für einen einzelnen Artikel auch `item_detail` (`is_reserved`, `can_buy`).
• `catalog_search` und `item_detail` kosten 2 Credits pro Aufruf, alle anderen Endpunkte 1. Zwischengespeichert wird nichts: Auch Kategorien, Größen, Farben und Länder holt jeder Aufruf frisch von vinted.de.