Zum Inhalt springen

API-Referenz / Fahrzeuge

Aktive Auktionsfahrzeuge suchen

GET/carsSeitengröße 50 / 1000

Suche 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.
  1. Ändere die Werte unten
  2. Die Anfrage rechts passt sich anDie Anfrage oben passt sich an
  3. Mit deinem Key live ausführen

Query-Parameter 46

integer

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.

integer · 1–4320

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.

integer · 1–1000

Datensätze pro Seite. Ohne Angabe 50. Maximal 1000 bei Unlimited; Demo und Small sind auf 50 begrenzt.

integer · 1+

Seitennummer, beginnend bei 1. Weglassen für Seite 1.

integer · 0–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.

string

Sortiert Fahrzeuge nach interner Fahrzeug-ID: asc (Standard) oder desc. Sortiert nicht nach Auktionszeit oder Preis.

integer · 0–1

1 setzen, um das Array des Preisverlaufs für jedes Los zu erhalten. Weglassen oder 0 für die Standardantwort.

string

Eine Hersteller-ID oder kommagetrennte IDs aus /manufacturers/{type}, zum Beispiel 16 (BMW) oder 16,20. Als einen String senden, nicht als Array.

integer · 1+

Interne Modell-ID aus /models/{manufacturer_id}/{type}.

integer · 1+

Interne Generations-ID aus /generations/{model_id}/{type}.

integer

Exaktes Modelljahr, zum Beispiel 2020. Auf /cars wird es zusammen mit einem Jahresbereich angewendet.

integer

Kleinstes Modelljahr, inklusive. Kombinierbar mit to_year.

integer

Größtes Modelljahr, inklusive. Kombinierbar mit from_year.

string

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.

string

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.

string

Teilstring des Fahrzeugtitels ohne Beachtung der Groß- und Kleinschreibung, zum Beispiel Corvette.

integer

ID der Fahrzeugkategorie. Siehe die erlaubten Werte unten.

integer

ID der Karosserieform. Siehe die erlaubten Werte unten.

integer

ID der Außenfarbe. Siehe die erlaubten Werte unten.

integer

ID der Kraftstoffart. Siehe die erlaubten Werte unten.

integer

Getriebe-ID: 1 = Automatik, 2 = Schaltgetriebe.

integer

Antriebs-ID: 1 = Heck, 2 = Front, 3 = Allrad.

integer

Zustands-ID des Inserats. Siehe die erlaubten Werte unten.

integer

Exakte Zylinderzahl des Motors, zum Beispiel 4, 6 oder 8.

string

Teilstring der Motorbezeichnung ohne Beachtung der Groß- und Kleinschreibung, zum Beispiel 2.0.

string

Zweistelliger Ländercode des Fahrzeugstandorts, zum Beispiel US oder CA. Weglassen, um alle verfügbaren Länder einzuschließen.

string

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.

string

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.

string

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.

integer

ID des Auktionsstatus. Siehe die erlaubten Werte unten. Für mehrere Status nutze stattdessen status[]; sende nicht beides.

array of integers

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.

integer · 0–1

1 setzen, um einen positiven Buy-Now-Preis zu verlangen. 0 oder Weglassen filtert Buy Now nicht.

number · 1+

Kleinster Buy-Now-Preis, inklusive (ab 1, Dezimalzahlen erlaubt). Beträge in den gespeicherten Preiseinheiten der Quelle, ohne Umrechnung oder Gebühren.

number · 1+

Größter Buy-Now-Preis, inklusive (ab 1, Dezimalzahlen erlaubt). Beträge in den gespeicherten Preiseinheiten der Quelle, ohne Umrechnung oder Gebühren.

number · 1+

Kleinstes gespeichertes Gebot, inklusive (ab 1, Dezimalzahlen erlaubt). Das ist nicht der endgültige Verkaufsbetrag.

number · 1+

Größtes gespeichertes Gebot, inklusive (ab 1, Dezimalzahlen erlaubt). Das ist nicht der endgültige Verkaufsbetrag.

integer · 1+

Kleinster erfasster Kilometerstand in Kilometern, inklusive. Sind Kilometer- und Meilenfilter gesetzt, müssen beide passen.

integer · 1+

Größter erfasster Kilometerstand in Kilometern, inklusive. Sind Kilometer- und Meilenfilter gesetzt, müssen beide passen.

integer · 1+

Kleinster erfasster Kilometerstand in Meilen, inklusive. Sind Kilometer- und Meilenfilter gesetzt, müssen beide passen.

integer · 1+

Größter erfasster Kilometerstand in Meilen, inklusive. Sind Kilometer- und Meilenfilter gesetzt, müssen beide passen.

string (date)

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.

string (date)

Auktionsdatum strikt vor diesem Kalenderdatum (YYYY-MM-DD). Die Uhrzeit wird ignoriert. Wird mit without_sale_date=1 ignoriert.

integer · 1+

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.

integer · 1+

Auktionszeitpunkte zwischen jetzt und in N Stunden, inklusive, zum Beispiel 24. Wird mit den anderen aktiven Datumsfiltern kombiniert.

integer · 0–1

1 setzen, um Lose ohne Verkaufsdatum zu wählen. Hat Vorrang vor sale_date_from, sale_date_to und sale_date_in_days.

integer · 0–1

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.

© 2025. AuctionsAPI operates independently and is not affiliated with Copart, IAAI or Encar.