API-Referenz / Fahrzeuge
Aktive Auktionsfahrzeuge suchen
/carsSeitengröße 50 / 1000Suche Fahrzeuge mit aktiven Inseraten bei Copart oder IAAI. Für Beschaffung, Importeur-Bestand, Monitoring und Marktanalyse.
- Filtere nach Quelle, Hersteller, Modell, Generation, Baujahr, Laufleistung, Preis, Standort, Schaden und Auktionsdetails. Alle Query-Parameter sind optional.
- Die Standard-Seitengröße ist in jedem Tarif 50; das Maximum ist 1000 bei Unlimited. Fahrzeuge sind nach interner ID sortiert, standardmäßig aufsteigend. Nutze minutes für Updates der letzten 4320 Minuten (72 Stunden) und
/archived-lots, um Entfernungen zu verfolgen. - Liefert Fahrzeuge in data, mit Paginierung in links und meta. Jedes Fahrzeug enthält technische Daten und ein Array lots mit Quellkennungen, Fotos, Laufleistung, Preisen, Auktionsdaten und Zustand, sofern vorhanden. Ergänze
prices_history=1,um das Array prices jedes Loses zu erhalten. - Ein aktives Inserat garantiert nicht, dass die Gebotsphase läuft. Zu einer aktuellen Einschränkung der Implementierung siehe
exclude_expired_auctions.
- Ändere die Werte unten
- Die Anfrage rechts passt sich anDie Anfrage oben passt sich an
- Mit deinem Key live ausführen
Query-Parameter 46
ID der Quellplattform: 1 = IAAI, 3 = Copart. Weglassen, um alle Quellen deines Kontos zu durchsuchen. Filtert passende Fahrzeuge; ihre verschachtelten Lose können andere Quellen enthalten.
Fahrzeuge oder Inserate, die in den letzten N Minuten aktualisiert wurden. 1–4320 (bis 72 Stunden), zum Beispiel 60. Für den normalen Feed weglassen.
Datensätze pro Seite. Ohne Angabe 50. Maximal 1000 bei Unlimited; Demo und Small sind auf 50 begrenzt.
Seitennummer, beginnend bei 1. Weglassen für Seite 1.
1 setzen, um Gesamtzahlen zu überspringen, oder 0, um sie einzuschließen. Weglassen für die Voreinstellung deines Kontos. Einfache Paginierung eignet sich für große Synchronisierungen.
Sortiert Fahrzeuge nach interner Fahrzeug-ID: asc (Standard) oder desc. Sortiert nicht nach Auktionszeit oder Preis.
1 setzen, um das Array des Preisverlaufs für jedes Los zu erhalten. Weglassen oder 0 für die Standardantwort.
Eine Hersteller-ID oder kommagetrennte IDs aus /manufacturers/{type}, zum Beispiel 16 (BMW) oder 16,20. Als einen String senden, nicht als Array.
Interne Modell-ID aus /models/{manufacturer_id}/{type}.
Interne Generations-ID aus /generations/{model_id}/{type}.
Exaktes Modelljahr, zum Beispiel 2020. Auf /cars wird es zusammen mit einem Jahresbereich angewendet.
Kleinstes Modelljahr, inklusive. Kombinierbar mit to_year.
Größtes Modelljahr, inklusive. Kombinierbar mit from_year.
Eine VIN (Vergleich mit dem gespeicherten Wert, ohne Beachtung der Groß- und Kleinschreibung) oder eine Losnummer der Quelle. Für einen reinen VIN-Filter nutze vin; für eine Abfrage aktiver und archivierter Inserate /search-vin oder /search-lot.
VIN-Filter ohne Beachtung der Groß- und Kleinschreibung. _ dient als Platzhalter für mehrere Zeichen: YV1MC_ findet VINs, die mit YV1MC beginnen. Ohne Platzhalter wird der ganze gespeicherte Wert verglichen.
Teilstring des Fahrzeugtitels ohne Beachtung der Groß- und Kleinschreibung, zum Beispiel Corvette.
ID der Fahrzeugkategorie. Siehe die erlaubten Werte unten.
ID der Karosserieform. Siehe die erlaubten Werte unten.
ID der Außenfarbe. Siehe die erlaubten Werte unten.
ID der Kraftstoffart. Siehe die erlaubten Werte unten.
Getriebe-ID: 1 = Automatik, 2 = Schaltgetriebe.
Antriebs-ID: 1 = Heck, 2 = Front, 3 = Allrad.
Zustands-ID des Inserats. Siehe die erlaubten Werte unten.
Exakte Zylinderzahl des Motors, zum Beispiel 4, 6 oder 8.
Teilstring der Motorbezeichnung ohne Beachtung der Groß- und Kleinschreibung, zum Beispiel 2.0.
Zweistelliger Ländercode des Fahrzeugstandorts, zum Beispiel US oder CA. Weglassen, um alle verfügbaren Länder einzuschließen.
Code des Bundesstaats oder der Provinz aus /usa/states, zum Beispiel CA oder FL. Ohne Beachtung der Groß- und Kleinschreibung; kombiniere ihn mit country, um Standorte mit gleichem Code zu unterscheiden.
Teilstring einer Haupt- oder Nebenschadensbezeichnung aus /usa/damages, zum Beispiel hail oder front, ohne Beachtung der Groß- und Kleinschreibung. Als einfachen String senden. Passt kein Schaden aus dem Verzeichnis, wird der Filter nicht angewendet.
Teilstring eines Title-Namens aus /usa/titles, zum Beispiel salvage, ohne Beachtung der Groß- und Kleinschreibung. Prüft den Title des Inserats, den ausführlichen und den kurzen. Passt kein Title aus dem Verzeichnis, wird der Filter nicht angewendet.
ID des Auktionsstatus. Siehe die erlaubten Werte unten. Für mehrere Status nutze stattdessen status[]; sende nicht beides.
Mehrere IDs des Auktionsstatus (1–10) als wiederholte Schlüssel mit Klammern, zum Beispiel status[]=4&status[]=5. Statt status nutzen. Sende weder status=[] noch einen JSON-String.
1 setzen, um einen positiven Buy-Now-Preis zu verlangen. 0 oder Weglassen filtert Buy Now nicht.
Kleinster Buy-Now-Preis, inklusive (ab 1, Dezimalzahlen erlaubt). Beträge in den gespeicherten Preiseinheiten der Quelle, ohne Umrechnung oder Gebühren.
Größter Buy-Now-Preis, inklusive (ab 1, Dezimalzahlen erlaubt). Beträge in den gespeicherten Preiseinheiten der Quelle, ohne Umrechnung oder Gebühren.
Kleinstes gespeichertes Gebot, inklusive (ab 1, Dezimalzahlen erlaubt). Das ist nicht der endgültige Verkaufsbetrag.
Größtes gespeichertes Gebot, inklusive (ab 1, Dezimalzahlen erlaubt). Das ist nicht der endgültige Verkaufsbetrag.
Kleinster erfasster Kilometerstand in Kilometern, inklusive. Sind Kilometer- und Meilenfilter gesetzt, müssen beide passen.
Größter erfasster Kilometerstand in Kilometern, inklusive. Sind Kilometer- und Meilenfilter gesetzt, müssen beide passen.
Kleinster erfasster Kilometerstand in Meilen, inklusive. Sind Kilometer- und Meilenfilter gesetzt, müssen beide passen.
Größter erfasster Kilometerstand in Meilen, inklusive. Sind Kilometer- und Meilenfilter gesetzt, müssen beide passen.
Auktionsdatum strikt nach diesem Kalenderdatum (YYYY-MM-DD). Die Uhrzeit wird ignoriert. Hat Vorrang vor sale_date_in_days; wird mit without_sale_date=1 ignoriert.
Auktionsdatum strikt vor diesem Kalenderdatum (YYYY-MM-DD). Die Uhrzeit wird ignoriert. Wird mit without_sale_date=1 ignoriert.
Lose, deren Auktionsdatum nach dem Zeitpunkt vor N Tagen liegt, einschließlich künftiger Termine. sale_date_from hat Vorrang; wird mit without_sale_date=1 ignoriert.
Auktionszeitpunkte zwischen jetzt und in N Stunden, inklusive, zum Beispiel 24. Wird mit den anderen aktiven Datumsfiltern kombiniert.
1 setzen, um Lose ohne Verkaufsdatum zu wählen. Hat Vorrang vor sale_date_from, sale_date_to und sale_date_in_days.
Aktuelle Einschränkung der Implementierung: Trotz des Namens wählt 1 Lose ohne Verkaufsdatum oder mit einem Verkaufsdatum vor jetzt, schließt vergangene Auktionen also nicht aus. Weglassen oder 0 nutzen; für ein kommendes Zeitfenster next_hours_auction nutzen.