Sari la conținut

Referință API / Vehicule

Caută vehicule active la licitație

GET/carsDimensiunea paginii 50 / 1000

Caută vehicule cu listări active Copart sau IAAI. Folosește-l pentru aprovizionare, inventar de importator, monitorizare și analiză de piață.

  • Filtrează după sursă, producător, model, generație, an, kilometraj, preț, locație, avarii și detalii de licitație. Toți parametrii de interogare sunt opționali.
  • Dimensiunea implicită a paginii este 50 pe orice plan; maximul este 1000 pe Unlimited. Vehiculele sunt ordonate după ID intern, implicit crescător. Folosește minutes pentru actualizări din ultimele 4320 de minute (72 de ore) și /archived-lots pentru a urmări eliminările.
  • Returnează vehiculele în data, cu paginarea în links și meta. Fiecare vehicul include specificații și un array lots cu identificatori sursă, fotografii, kilometraj, prețuri, date de licitație și starea, când sunt disponibile. Adaugă prices_history=1 pentru a include array-ul prices al fiecărui lot.
  • O listare activă nu garantează că licitarea este deschisă. Vezi exclude_expired_auctions pentru o limitare actuală a implementării.
  1. Schimbă valorile de mai jos
  2. Cererea din dreapta se actualizeazăCererea de mai sus se actualizează
  3. Rulează live cu cheia ta

Parametri de interogare 46

integer

ID-ul platformei sursă: 1 = IAAI, 3 = Copart. Omite pentru a căuta în toate sursele disponibile contului tău. Filtrează vehiculele potrivite; lots imbricate pot include alte surse.

integer · 1–4320

Vehicule sau listări actualizate în ultimele N minute. Folosește 1–4320 (până la 72 de ore), de exemplu 60. Omite pentru fluxul normal.

integer · 1–1000

Înregistrări per pagină. Omite pentru 50. Maximum 1000 pe Unlimited; Demo și Small sunt limitate la 50.

integer · 1+

Numărul paginii, începând de la 1. Omite pentru a cere pagina 1.

integer · 0–1

Setează 1 pentru a sări peste totaluri sau 0 pentru a le include. Omite pentru a folosi valoarea implicită a contului tău. Paginarea simplă se potrivește sincronizărilor mari.

string

Ordonează vehiculele după ID-ul intern al mașinii: asc (implicit) sau desc. Nu sortează după ora licitației sau preț.

integer · 0–1

Setează 1 pentru a include array-ul istoricului prețurilor pentru fiecare lot. Omite sau folosește 0 pentru răspunsul standard.

string

Un ID de producător sau ID-uri separate prin virgulă din /manufacturers/{type}, de exemplu 16 (BMW) sau 16,20. Trimite un singur șir, nu un array.

integer · 1+

ID intern de model din /models/{manufacturer_id}/{type}.

integer · 1+

ID intern de generație din /generations/{model_id}/{type}.

integer

Anul exact al modelului, de exemplu 2020. În /cars se aplică împreună cu orice interval de ani.

integer

Anul minim al modelului, inclusiv. Poate fi combinat cu to_year.

integer

Anul maxim al modelului, inclusiv. Poate fi combinat cu from_year.

string

Un VIN (potrivire cu valoarea stocată, fără distincție între majuscule și minuscule) sau un număr de lot din sursă. Pentru un filtru doar după VIN folosește vin; pentru o căutare în listările active și arhivate folosește /search-vin sau /search-lot.

string

Filtru VIN fără distincție între majuscule și minuscule. Folosește _ ca wildcard pentru mai multe caractere: YV1MC_ potrivește VIN-urile care încep cu YV1MC. Fără wildcard potrivește valoarea stocată completă.

string

Subșir al titlului vehiculului, fără distincție între majuscule și minuscule, de exemplu Corvette.

integer

ID-ul categoriei de vehicul. Vezi valorile acceptate mai jos.

integer

ID-ul tipului de caroserie. Vezi valorile acceptate mai jos.

integer

ID-ul culorii exterioare. Vezi valorile acceptate mai jos.

integer

ID-ul tipului de combustibil. Vezi valorile acceptate mai jos.

integer

ID-ul transmisiei: 1 = automată, 2 = manuală.

integer

ID-ul tracțiunii: 1 = spate, 2 = față, 3 = integrală.

integer

ID-ul stării listării. Vezi valorile acceptate mai jos.

integer

Numărul exact de cilindri ai motorului, de exemplu 4, 6 sau 8.

string

Subșir al denumirii motorului, fără distincție între majuscule și minuscule, de exemplu 2.0.

string

Codul de țară din două litere al locației vehiculului, de exemplu US sau CA. Omite pentru a include toate țările disponibile.

string

Codul statului sau provinciei din /usa/states, de exemplu CA sau FL. Fără distincție între majuscule și minuscule; combină cu country pentru a deosebi locațiile cu același cod.

string

Subșir al denumirii unei avarii primare sau secundare din /usa/damages, fără distincție între majuscule și minuscule, de exemplu hail sau front. Trimite un șir scalar. Dacă nicio avarie din dicționar nu se potrivește, filtrul nu se aplică.

string

Subșir al denumirii unui titlu de document din /usa/titles, fără distincție între majuscule și minuscule, de exemplu salvage. Verifică titlul listării, cel detaliat și cel scurt. Dacă niciun titlu din dicționar nu se potrivește, filtrul nu se aplică.

integer

ID-ul statusului licitației. Vezi valorile acceptate mai jos. Pentru mai multe statusuri folosește status[] în loc; nu trimite ambele.

array of integers

Mai multe ID-uri de status ale licitației (1–10) ca chei repetate cu paranteze, de exemplu status[]=4&status[]=5. Folosește în loc de status. Nu trimite status=[] sau un șir JSON.

integer · 0–1

Setează 1 pentru a cere un preț Buy Now pozitiv. 0 sau omiterea lasă Buy Now nefiltrat.

number · 1+

Prețul Buy Now minim, inclusiv (1 sau mai mult, zecimalele sunt acceptate). Sumele folosesc unitățile de preț stocate din sursă, fără conversie sau taxe.

number · 1+

Prețul Buy Now maxim, inclusiv (1 sau mai mult, zecimalele sunt acceptate). Sumele folosesc unitățile de preț stocate din sursă, fără conversie sau taxe.

number · 1+

Oferta stocată minimă, inclusiv (1 sau mai mult, zecimalele sunt acceptate). Aceasta nu este suma vânzării finale.

number · 1+

Oferta stocată maximă, inclusiv (1 sau mai mult, zecimalele sunt acceptate). Aceasta nu este suma vânzării finale.

integer · 1+

Citirea minimă înregistrată a odometrului în kilometri, inclusiv. Dacă filtrele în kilometri și în mile sunt setate ambele, trebuie să se potrivească amândouă.

integer · 1+

Citirea maximă înregistrată a odometrului în kilometri, inclusiv. Dacă filtrele în kilometri și în mile sunt setate ambele, trebuie să se potrivească amândouă.

integer · 1+

Citirea minimă înregistrată a odometrului în mile, inclusiv. Dacă filtrele în kilometri și în mile sunt setate ambele, trebuie să se potrivească amândouă.

integer · 1+

Citirea maximă înregistrată a odometrului în mile, inclusiv. Dacă filtrele în kilometri și în mile sunt setate ambele, trebuie să se potrivească amândouă.

string (date)

Data licitației strict după această dată calendaristică (YYYY-MM-DD). Partea de oră este ignorată. Suprascrie sale_date_in_days; ignorat cu without_sale_date=1.

string (date)

Data licitației strict înainte de această dată calendaristică (YYYY-MM-DD). Partea de oră este ignorată. Ignorat cu without_sale_date=1.

integer · 1+

Loturi a căror dată de licitație este mai târzie decât acum N zile, inclusiv datele viitoare. Suprascris de sale_date_from; ignorat cu without_sale_date=1.

integer · 1+

Momente de licitație între acum și peste N ore, inclusiv, de exemplu 24. Se combină cu celelalte filtre de dată activate.

integer · 0–1

Setează 1 pentru a selecta loturile fără dată de vânzare. Suprascrie sale_date_from, sale_date_to și sale_date_in_days.

integer · 0–1

Limitare actuală a implementării: în ciuda numelui, 1 selectează loturile fără dată de vânzare sau cu o dată de vânzare anterioară momentului actual, deci nu exclude licitațiile trecute. Omite-l sau folosește 0; folosește next_hours_auction pentru o fereastră viitoare.

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