Към съдържанието

API справочник / Автомобили

Търсене на активни автомобили от аукциони

GET/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 за текущо ограничение на реализацията.
  1. Променете стойностите по-долу
  2. Заявката вдясно се обновяваЗаявката по-горе се обновява
  3. Изпълнете я на живо с ключа си

Query параметри 46

integer

ID на платформата източник: 1 = IAAI, 3 = Copart. Пропуснете, за да търсите във всички достъпни за акаунта ви източници. Филтрира съвпадащите автомобили; вложените им лотове може да са от други източници.

integer · 1–4320

Автомобили или обяви, обновени през последните N минути. Използвайте 1–4320 (до 72 часа), например 60. Пропуснете за обичайния поток.

integer · 1–1000

Записи на страница. Пропуснете за 50. Максимум 1000 в Unlimited; Demo и Small са ограничени до 50.

integer · 1+

Номер на страницата, започва от 1. Пропуснете, за да заявите страница 1.

integer · 0–1

Задайте 1, за да пропуснете общия брой, или 0, за да го включите. Пропуснете, за да използвате настройката на акаунта. Простата пагинация е подходяща за големи синхронизации.

string

Подрежда автомобилите по вътрешно ID: asc (по подразбиране) или desc. Не сортира по време на търга или цена.

integer · 0–1

Задайте 1, за да включите масива с историята на цените за всеки лот. Пропуснете или използвайте 0 за стандартния отговор.

string

Едно ID на производител или няколко ID, разделени със запетая, от /manufacturers/{type}, например 16 (BMW) или 16,20. Изпратете един низ, а не масив.

integer · 1+

Вътрешно ID на модел от /models/{manufacturer_id}/{type}.

integer · 1+

Вътрешно ID на поколение от /generations/{model_id}/{type}.

integer

Точна моделна година, например 2020. В /cars се прилага заедно с всеки диапазон от години.

integer

Минимална моделна година, включително. Може да се комбинира с to_year.

integer

Максимална моделна година, включително. Може да се комбинира с from_year.

string

VIN (съвпадение със записаната стойност без значение от регистъра) или номер на лот от източника. За филтър само по VIN използвайте vin; за търсене в активните и архивните обяви – /search-vin или /search-lot.

string

Филтър по VIN без значение от регистъра. Използвайте _ като заместител за няколко символа: YV1MC_ съвпада с VIN, започващи с YV1MC. Без заместител съвпада с цялата записана стойност.

string

Подниз от заглавието на автомобила без значение от регистъра, например Corvette.

integer

ID на категорията превозно средство. Вижте допустимите стойности по-долу.

integer

ID на типа купе. Вижте допустимите стойности по-долу.

integer

ID на цвета на купето. Вижте допустимите стойности по-долу.

integer

ID на вида гориво. Вижте допустимите стойности по-долу.

integer

ID на скоростната кутия: 1 = автоматична, 2 = ръчна.

integer

ID на задвижването: 1 = задно, 2 = предно, 3 = 4x4.

integer

ID на състоянието в обявата. Вижте допустимите стойности по-долу.

integer

Точен брой цилиндри на двигателя, например 4, 6 или 8.

string

Подниз от името на двигателя без значение от регистъра, например 2.0.

string

Двубуквен код на държавата, в която се намира автомобилът, например US или CA. Пропуснете, за да включите всички налични държави.

string

Код на щат или провинция от /usa/states, например CA или FL. Без значение от регистъра; комбинирайте с country, за да различите местоположения с еднакъв код.

string

Подниз от името на основна или вторична щета от /usa/damages без значение от регистъра, например hail или front. Изпратете единичен низ. Ако нито една щета от справочника не съвпада, филтърът не се прилага.

string

Подниз от името на титла от /usa/titles без значение от регистъра, например salvage. Проверява титлата в обявата, подробната и кратката. Ако нито една титла от справочника не съвпада, филтърът не се прилага.

integer

ID на статуса на търга. Вижте допустимите стойности по-долу. За няколко статуса използвайте status[]; не изпращайте и двата.

array of integers

Няколко ID на статус на търга (1–10) като повтарящи се ключове със скоби, например status[]=4&status[]=5. Използвайте вместо status. Не изпращайте status=[] или JSON низ.

integer · 0–1

Задайте 1, за да изискате положителна цена Buy Now. 0 или пропускане оставя Buy Now без филтър.

number · 1+

Минимална цена Buy Now, включително (1 или повече, допускат се десетични). Сумите са в записаните ценови единици на източника, без конвертиране и такси.

number · 1+

Максимална цена Buy Now, включително (1 или повече, допускат се десетични). Сумите са в записаните ценови единици на източника, без конвертиране и такси.

number · 1+

Минимална записана оферта, включително (1 или повече, допускат се десетични). Това не е сумата на окончателната продажба.

number · 1+

Максимална записана оферта, включително (1 или повече, допускат се десетични). Това не е сумата на окончателната продажба.

integer · 1+

Минимален записан километраж в километри, включително. Ако са зададени филтри и в километри, и в мили, трябва да съвпадат и двата.

integer · 1+

Максимален записан километраж в километри, включително. Ако са зададени филтри и в километри, и в мили, трябва да съвпадат и двата.

integer · 1+

Минимален записан пробег в мили, включително. Ако са зададени филтри и в километри, и в мили, трябва да съвпадат и двата.

integer · 1+

Максимален записан пробег в мили, включително. Ако са зададени филтри и в километри, и в мили, трябва да съвпадат и двата.

string (date)

Дата на търга строго след тази календарна дата (YYYY-MM-DD). Часът се игнорира. Има предимство пред sale_date_in_days; игнорира се при without_sale_date=1.

string (date)

Дата на търга строго преди тази календарна дата (YYYY-MM-DD). Часът се игнорира. Игнорира се при without_sale_date=1.

integer · 1+

Лотове с дата на търга по-късна от преди N дни, включително бъдещи дати. sale_date_from има предимство; игнорира се при without_sale_date=1.

integer · 1+

Време на търга между сега и след N часа, включително, например 24. Комбинира се с другите включени филтри по дата.

integer · 0–1

Задайте 1, за да изберете лотове без дата на продажба. Има предимство пред sale_date_from, sale_date_to и sale_date_in_days.

integer · 0–1

Текущо ограничение на реализацията: въпреки името си, 1 избира лотове без дата на продажба или с дата на продажба преди текущия момент, така че не изключва минали търгове. Пропуснете го или използвайте 0; за предстоящ период използвайте next_hours_auction.

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