Guides

Syntax der Suchfilter

Filter stehen im Query-String von /cars. Alle sind optional und werden mit UND verknüpft.

Ungenutzte Filter weglassen

Sende nie einen leeren Wert wie domain_id= oder page=. Lass den Parameter einfach weg.

Quelle und Fahrzeug

domain_id=3 ist Copart und domain_id=1 ist IAAI. Damit wählst du Fahrzeuge mit passendem Inserat; ihre verschachtelten Lose können andere Quellen enthalten, also lies lots[].domain.id.

Mehrere Hersteller

manufacturer_id nimmt einen String mit kommagetrennten IDs, zum Beispiel 16,20. Sende kein Array.

Mehrere Status

Nutze wiederholte Schlüssel mit Klammern: status[]=4&status[]=5. Kombiniere status nicht mit status[] und sende nie status=[].

VIN-Suche

vin vergleicht die ganze gespeicherte VIN, ohne Groß- und Kleinschreibung zu beachten. Nutze _ als Platzhalter: YV1MC_ findet jede VIN, die mit YV1MC beginnt. search_query nimmt eine VIN oder eine Losnummer.

Baujahre

year ist exakt; from_year und to_year sind inklusive Grenzen. Auf /cars werden sie zusammen angewendet.

Auktionsdaten

sale_date_from und sale_date_to sind exklusive Kalenderdaten (YYYY-MM-DD). sale_date_from hat Vorrang vor sale_date_in_days, und without_sale_date=1 hat Vorrang vor allen dreien.

Kürzlich geändert

minutes=60 liefert Fahrzeuge, die in der letzten Stunde aktualisiert wurden. Erlaubt sind 1–4320 Minuten (72 Stunden).

Preise und Kilometerstand

buy_now_price_* und bid_price_* nutzen die gespeicherten Preiseinheiten der Quelle, ohne Umrechnung oder Gebühren. Sind Grenzen in Kilometern und Meilen gesetzt, müssen beide passen.

Textfilter

name, engine_name, damage und document_title sind Teilstrings ohne Beachtung der Groß- und Kleinschreibung. Findet damage oder document_title nichts im Verzeichnis, wird der Filter nicht angewendet.