API справочник / Автомобили
Търсене на активни автомобили от аукциони
/carsРазмер на страницата 50 / 1000Търсете автомобили с активни обяви в Copart или IAAI. Подходящо за намиране на автомобили, наличност на вносители, мониторинг и пазарен анализ.
- Филтрирайте по източник, производител, модел, поколение, година, пробег, цена, местоположение, щети и данни за търга. Всички query параметри са незадължителни.
- Размерът на страницата по подразбиране е 50 във всеки план; максимумът е 1000 в Unlimited. Автомобилите са подредени по вътрешно ID, по подразбиране възходящо. Използвайте minutes за обновявания през последните 4320 минути (72 часа) и
/archived-lots, за да следите премахванията. - Връща автомобилите в data, а пагинацията – в links и meta. Всеки автомобил съдържа характеристики и масив lots с идентификатори на източника, снимки, пробег, цени, дати на търговете и състояние, когато са налични. Добавете
prices_history=1,за да включите масива prices на всеки лот. - Активната обява не гарантира, че наддаването е отворено. Вижте
exclude_expired_auctionsза текущо ограничение на реализацията.
- Променете стойностите по-долу
- Заявката вдясно се обновяваЗаявката по-горе се обновява
- Изпълнете я на живо с ключа си
Query параметри 46
ID на платформата източник: 1 = IAAI, 3 = Copart. Пропуснете, за да търсите във всички достъпни за акаунта ви източници. Филтрира съвпадащите автомобили; вложените им лотове може да са от други източници.
Автомобили или обяви, обновени през последните N минути. Използвайте 1–4320 (до 72 часа), например 60. Пропуснете за обичайния поток.
Записи на страница. Пропуснете за 50. Максимум 1000 в Unlimited; Demo и Small са ограничени до 50.
Номер на страницата, започва от 1. Пропуснете, за да заявите страница 1.
Задайте 1, за да пропуснете общия брой, или 0, за да го включите. Пропуснете, за да използвате настройката на акаунта. Простата пагинация е подходяща за големи синхронизации.
Подрежда автомобилите по вътрешно ID: asc (по подразбиране) или desc. Не сортира по време на търга или цена.
Задайте 1, за да включите масива с историята на цените за всеки лот. Пропуснете или използвайте 0 за стандартния отговор.
Едно ID на производител или няколко ID, разделени със запетая, от /manufacturers/{type}, например 16 (BMW) или 16,20. Изпратете един низ, а не масив.
Вътрешно ID на модел от /models/{manufacturer_id}/{type}.
Вътрешно ID на поколение от /generations/{model_id}/{type}.
Точна моделна година, например 2020. В /cars се прилага заедно с всеки диапазон от години.
Минимална моделна година, включително. Може да се комбинира с to_year.
Максимална моделна година, включително. Може да се комбинира с from_year.
VIN (съвпадение със записаната стойност без значение от регистъра) или номер на лот от източника. За филтър само по VIN използвайте vin; за търсене в активните и архивните обяви – /search-vin или /search-lot.
Филтър по VIN без значение от регистъра. Използвайте _ като заместител за няколко символа: YV1MC_ съвпада с VIN, започващи с YV1MC. Без заместител съвпада с цялата записана стойност.
Подниз от заглавието на автомобила без значение от регистъра, например Corvette.
ID на категорията превозно средство. Вижте допустимите стойности по-долу.
ID на типа купе. Вижте допустимите стойности по-долу.
ID на цвета на купето. Вижте допустимите стойности по-долу.
ID на вида гориво. Вижте допустимите стойности по-долу.
ID на скоростната кутия: 1 = автоматична, 2 = ръчна.
ID на задвижването: 1 = задно, 2 = предно, 3 = 4x4.
ID на състоянието в обявата. Вижте допустимите стойности по-долу.
Точен брой цилиндри на двигателя, например 4, 6 или 8.
Подниз от името на двигателя без значение от регистъра, например 2.0.
Двубуквен код на държавата, в която се намира автомобилът, например US или CA. Пропуснете, за да включите всички налични държави.
Код на щат или провинция от /usa/states, например CA или FL. Без значение от регистъра; комбинирайте с country, за да различите местоположения с еднакъв код.
Подниз от името на основна или вторична щета от /usa/damages без значение от регистъра, например hail или front. Изпратете единичен низ. Ако нито една щета от справочника не съвпада, филтърът не се прилага.
Подниз от името на титла от /usa/titles без значение от регистъра, например salvage. Проверява титлата в обявата, подробната и кратката. Ако нито една титла от справочника не съвпада, филтърът не се прилага.
ID на статуса на търга. Вижте допустимите стойности по-долу. За няколко статуса използвайте status[]; не изпращайте и двата.
Няколко ID на статус на търга (1–10) като повтарящи се ключове със скоби, например status[]=4&status[]=5. Използвайте вместо status. Не изпращайте status=[] или JSON низ.
Задайте 1, за да изискате положителна цена Buy Now. 0 или пропускане оставя Buy Now без филтър.
Минимална цена Buy Now, включително (1 или повече, допускат се десетични). Сумите са в записаните ценови единици на източника, без конвертиране и такси.
Максимална цена Buy Now, включително (1 или повече, допускат се десетични). Сумите са в записаните ценови единици на източника, без конвертиране и такси.
Минимална записана оферта, включително (1 или повече, допускат се десетични). Това не е сумата на окончателната продажба.
Максимална записана оферта, включително (1 или повече, допускат се десетични). Това не е сумата на окончателната продажба.
Минимален записан километраж в километри, включително. Ако са зададени филтри и в километри, и в мили, трябва да съвпадат и двата.
Максимален записан километраж в километри, включително. Ако са зададени филтри и в километри, и в мили, трябва да съвпадат и двата.
Минимален записан пробег в мили, включително. Ако са зададени филтри и в километри, и в мили, трябва да съвпадат и двата.
Максимален записан пробег в мили, включително. Ако са зададени филтри и в километри, и в мили, трябва да съвпадат и двата.
Дата на търга строго след тази календарна дата (YYYY-MM-DD). Часът се игнорира. Има предимство пред sale_date_in_days; игнорира се при without_sale_date=1.
Дата на търга строго преди тази календарна дата (YYYY-MM-DD). Часът се игнорира. Игнорира се при without_sale_date=1.
Лотове с дата на търга по-късна от преди N дни, включително бъдещи дати. sale_date_from има предимство; игнорира се при without_sale_date=1.
Време на търга между сега и след N часа, включително, например 24. Комбинира се с другите включени филтри по дата.
Задайте 1, за да изберете лотове без дата на продажба. Има предимство пред sale_date_from, sale_date_to и sale_date_in_days.
Текущо ограничение на реализацията: въпреки името си, 1 избира лотове без дата на продажба или с дата на продажба преди текущия момент, така че не изключва минали търгове. Пропуснете го или използвайте 0; за предстоящ период използвайте next_hours_auction.