Referință API / Vehicule
Caută vehicule active la licitație
/carsDimensiunea paginii 50 / 1000Caută 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-lotspentru 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=1pentru a include array-ul prices al fiecărui lot. - O listare activă nu garantează că licitarea este deschisă. Vezi
exclude_expired_auctionspentru o limitare actuală a implementării.
- Schimbă valorile de mai jos
- Cererea din dreapta se actualizeazăCererea de mai sus se actualizează
- Rulează live cu cheia ta
Parametri de interogare 46
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.
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.
Înregistrări per pagină. Omite pentru 50. Maximum 1000 pe Unlimited; Demo și Small sunt limitate la 50.
Numărul paginii, începând de la 1. Omite pentru a cere pagina 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.
Ordonează vehiculele după ID-ul intern al mașinii: asc (implicit) sau desc. Nu sortează după ora licitației sau preț.
Setează 1 pentru a include array-ul istoricului prețurilor pentru fiecare lot. Omite sau folosește 0 pentru răspunsul standard.
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.
ID intern de model din /models/{manufacturer_id}/{type}.
ID intern de generație din /generations/{model_id}/{type}.
Anul exact al modelului, de exemplu 2020. În /cars se aplică împreună cu orice interval de ani.
Anul minim al modelului, inclusiv. Poate fi combinat cu to_year.
Anul maxim al modelului, inclusiv. Poate fi combinat cu from_year.
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.
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ă.
Subșir al titlului vehiculului, fără distincție între majuscule și minuscule, de exemplu Corvette.
ID-ul categoriei de vehicul. Vezi valorile acceptate mai jos.
ID-ul tipului de caroserie. Vezi valorile acceptate mai jos.
ID-ul culorii exterioare. Vezi valorile acceptate mai jos.
ID-ul tipului de combustibil. Vezi valorile acceptate mai jos.
ID-ul transmisiei: 1 = automată, 2 = manuală.
ID-ul tracțiunii: 1 = spate, 2 = față, 3 = integrală.
ID-ul stării listării. Vezi valorile acceptate mai jos.
Numărul exact de cilindri ai motorului, de exemplu 4, 6 sau 8.
Subșir al denumirii motorului, fără distincție între majuscule și minuscule, de exemplu 2.0.
Codul de țară din două litere al locației vehiculului, de exemplu US sau CA. Omite pentru a include toate țările disponibile.
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.
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ă.
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ă.
ID-ul statusului licitației. Vezi valorile acceptate mai jos. Pentru mai multe statusuri folosește status[] în loc; nu trimite ambele.
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.
Setează 1 pentru a cere un preț Buy Now pozitiv. 0 sau omiterea lasă Buy Now nefiltrat.
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.
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.
Oferta stocată minimă, inclusiv (1 sau mai mult, zecimalele sunt acceptate). Aceasta nu este suma vânzării finale.
Oferta stocată maximă, inclusiv (1 sau mai mult, zecimalele sunt acceptate). Aceasta nu este suma vânzării finale.
Citirea minimă înregistrată a odometrului în kilometri, inclusiv. Dacă filtrele în kilometri și în mile sunt setate ambele, trebuie să se potrivească amândouă.
Citirea maximă înregistrată a odometrului în kilometri, inclusiv. Dacă filtrele în kilometri și în mile sunt setate ambele, trebuie să se potrivească amândouă.
Citirea minimă înregistrată a odometrului în mile, inclusiv. Dacă filtrele în kilometri și în mile sunt setate ambele, trebuie să se potrivească amândouă.
Citirea maximă înregistrată a odometrului în mile, inclusiv. Dacă filtrele în kilometri și în mile sunt setate ambele, trebuie să se potrivească amândouă.
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.
Data licitației strict înainte de această dată calendaristică (YYYY-MM-DD). Partea de oră este ignorată. Ignorat cu without_sale_date=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.
Momente de licitație între acum și peste N ore, inclusiv, de exemplu 24. Se combină cu celelalte filtre de dată activate.
Setează 1 pentru a selecta loturile fără dată de vânzare. Suprascrie sale_date_from, sale_date_to și sale_date_in_days.
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.