A
Apibara
API platforma
☰
Pradžia
Mūsų produktai
Copart ir IAAI automobilių aukcionų duomenų API YouTube Data API
Tinklaraštis Apie mus Kontaktai Prisijungti Pradėti
API dokumentacija

Copart ir IAAI automobilių aukcionų duomenų API

Ieškokite, stebėkite ir integruokite Copart bei IAAI automobilių aukcionų duomenis per vieną struktūruotą API. Gaukite VIN, lotus, kainas, nuotraukas, aukcionų būsenas ir pardavimo istoriją.
Produkto puslapis Endpoints

Endpoints

1) Gauti filtrų metaduomenis

GET /api/v1/vehicle-auction/vehicles/filters

Naudokite šį endpoint paieškos sąsajai kurti. Jis grąžina parinkčių sąrašus, numatytąsias reikšmes, intervalų ribas, lokacijos filtrus, shipping filtrų metaduomenis ir pardavimo dokumentų metaduomenis.

Atsakyme yra:

  1. loto statuso ir substatuso parinktys
  2. aukciono tipo parinktys
  3. markės ir modeliai, sugrupuoti pagal markę
  4. transporto tipai
  5. skaitiniai intervalai: kaina, metai, rida, variklis
  6. papildomi filtrai: spalva, kuras, transmisija, pavara, važiavimo būklė, pažeidimai, cilindrai, raktas
  7. aukciono datos filtro metaduomenys
  8. tik šiandien filtro metaduomenys
  9. pardavimo dokumentų filtro metaduomenys
  10. pardavėjo tipo filtro metaduomenys
  11. shipping filtro metaduomenys
  12. lokacijos filtrai: valstija, facility, biuro pavadinimas, zip/radius

2) Ieškoti transporto priemonių (pilnas loto payload)

GET /api/v1/vehicle-auction/vehicles

Grąžina transporto priemonių sąrašą, atitinkantį filtrus.
Kiekvienas elementas grąžinamas tuo pačiu pilnu “lot payload” formatu kaip ir vienos transporto priemonės endpoint.

Parametras Tipas Pavyzdys Aprašymas
s string 1G1BC5SM7H7259061 Paieška pagal VIN, loto numerį arba pavadinimą
per_page integer 20 Rezultatų skaičius puslapyje. Maksimali palaikoma reikšmė yra 20
cursor string eyJpZCI6MTIzfQ== Cursor pagination token iš meta.next_cursor arba meta.prev_cursor
lot_status string All Loto tipas: All, Buy Now, Timed
lot_sub_status string Open Aukciono būsenos filtras: Open, Live, Ended
auction_type integer 2 Platformos filtras: 0 = All, 1 = Copart, 2 = IAAI
make string Toyota Transporto markė
model string Camry Transporto modelis
type string Sedan Transporto tipas arba kėbulo kategorija pagal dataset
price_min number 0 Minimali dabartinė kaina USD
price_max number 6500 Maksimali dabartinė kaina USD
year_from integer 2015 Minimalūs transporto metai
year_to integer 2026 Maksimalūs transporto metai
odometer_from integer 0 Minimali rida myliomis
odometer_to integer 250000 Maksimali rida myliomis
engine_size_from number 1.6 Minimalus variklio tūris litrais
engine_size_to number 4.0 Maksimalus variklio tūris litrais
engine_hp_from integer 100 Minimali variklio galia
engine_hp_to integer 500 Maksimali variklio galia
color[] array color[]=Black&color[]=White Kelių išorės spalvų pasirinkimas
fuel_type[] array fuel_type[]=Gasoline Kelių kuro tipų pasirinkimas
transmission[] array transmission[]=Automatic Kelių transmisijos tipų pasirinkimas
drive_type[] array drive_type[]=AWD Kelių pavaros tipų pasirinkimas: AWD, FWD, RWD
run_cond string RUNS AND DRIVES Važiavimo būklė. Naudokite reikšmes iš /api/v1/vehicle-auction/vehicles/filters
damage[] array damage[]=Water Kelių pažeidimų grupių pasirinkimas. Naudokite reikšmes iš /api/v1/vehicle-auction/vehicles/filters
cylinders[] array cylinders[]=4 Kelių cilindrų skaičiaus pasirinkimas
has_key string With Rakto buvimo filtras. Palaikomos reikšmės: With, No, All
facility_id string 136 Filtras pagal aukciono facility / biuro ID
loc_state string FL Filtras pagal aukciono facility valstijos kodą
office_name string Birmingham Dalinis ieškojimas pagal aukciono biuro pavadinimą
zip string 33166 ZIP arba pašto kodas netoliese esantiems lotams ieškoti
radius number 50 Spindulys aplink ZIP/pašto kodą
units string mi Atstumo vienetai: km arba mi
auction_date_from string 2026-03-20 Pradžios data aukciono datos filtravimui. Formatas: YYYY-MM-DD
auction_date_to string 2026-03-25 Pabaigos data aukciono datos filtravimui. Formatas: YYYY-MM-DD
today_only boolean / integer 1 Grąžinti tik šiandien suplanuotus lotus
sale_document_pending boolean / integer 1 Grąžinti tik lotus su pending sale documents
sale_document_page_id integer 4 Filtras pagal nustatytą pardavimo dokumento page ID
sale_document_type string clean Filtras pagal nustatytą pardavimo dokumento tipą
seller_type string insurance Filtras pagal nustatytą pardavėjo tipą: insurance, non_insurance, dealer, finance
has_shipping_price boolean / integer 1 Grąžinti tik lotus, kuriems pavyko priskirti shipping kainą nuo aukciono iki uosto

Pastabos

  • Kai naudojami zip + radius, atsakyme gali būti distance laukas kiekvienam lotui.
  • Atstumas skaičiuojamas pagal loto koordinates; facility koordinatės naudojamos kaip fallback, jei jos prieinamos.
  • Pardavimo dokumentų ir pardavėjo tipo filtrai veikia best-effort principu ir priklauso nuo prieinamų source duomenų.

3) Gauti vieną transporto priemonę

GET /api/v1/vehicle-auction/vehicles/{vinOrLotNumber}

Grąžina vieną transporto priemonę pilnu lot payload formatu.

Parametras Tipas Pavyzdys Aprašymas
vinOrLotNumber string 2HKRM4H7XEH623608 arba 45416833 Transporto priemonės VIN arba aukciono loto numeris, naudojamas API. Priklausomai nuo realizacijos, gali būti atpažįstamas pagal slug/VIN arba loto numerį

Pagrindiniai atsakymo laukai

  • slug_vin — viešas Transporto priemonės VIN arba aukciono loto numeris
  • vin — VIN didžiosiomis raidėmis
  • platform, platform_id, lot_number
  • title, year, make, model, type
  • auction — aukciono būsena, tvarkaraštis, buy now / timed flagai, sold metadata
  • pricing — dabartinė kaina, buy now price, paskutinė pardavimo kaina, preliminarus istorinis intervalas
  • location — rodoma lokacija, rekomenduojamas shipping uostas, valstija
  • seller — pardavėjo pavadinimas ir nustatytas tipas
  • condition — važiavimo būklė, raktas, loss, pažeidimai
  • odometer — rida mi/km
  • vehicle_specs — variklis, transmisija, kuras, pavara, kėbulo tipas, airbags, restraint system
  • sale_document — nustatytas dokumento pavadinimas, tipas, lokalizuotas aprašymas, export, registration, page ID, pending flag
  • media — nuotraukos, video, 360 data
  • facility — facility ID, valstija, ZIP, koordinatės, biuro pavadinimas
  • distance — atstumas nuo nurodyto ZIP, kai naudojamas radius search
  • details — išplėstas raw IAAI detail block, jei prieinamas

4) Gauti transporto istoriją

GET /api/v1/vehicle-auction/vehicles/{vinOrLotNumber}/history

Grąžina loto pardavimo istorijos eilutes.

Parametras Tipas Pavyzdys Aprašymas
vinOrLotNumber string 2HKRM4H7XEH623608 arba 45416833 Transporto priemonės VIN arba aukciono loto numeris
per_page integer 50 Istorijos puslapio dydis
cursor string eyJpZCI6MTIzfQ== Cursor token puslapiavimui

Atsakyme yra:

  • vehicle.slug_vin
  • vehicle.vin
  • vehicle.platform
  • vehicle.lot_number
  • history[].platform
  • history[].date — formatuojama kaip Y-m-d
  • history[].price
  • history[].status

5) Gauti susijusias transporto priemones

GET /api/v1/vehicle-auction/vehicles/{vinOrLotNumber}/related

Grąžina susijusias transporto priemones iš tos pačios platformos, markės ir modelio.
Atsakymas padalintas į:

  • source — užklausta transporto priemonė
  • upcoming — susijusios aktyvios arba būsimos transporto priemonės
  • past — susijusios parduotos arba pašalintos transporto priemonės

6) Gauti shipping konkrečiai transporto priemonei

GET /api/v1/vehicle-auction/vehicles/{vinOrLotNumber}/shipping

Grąžina priskirtas shipping kainas nuo aukciono iki uosto vienai konkrečiai transporto priemonei.

Parametras Tipas Pavyzdys Aprašymas
vinOrLotNumber string 2HKRM4H7XEH623608 arba 45416833 Transporto priemonės VIN arba aukciono loto numeris
ports string Miami,NY,LA Kableliais atskirtas paskirties uostų sąrašas. Jei nepateikta, tikrinami visi palaikomi uostai

Atsakyme yra:

  • vehicle — platform, lot number, VIN, title, type
  • auction_location.display — žmogui suprantama aukciono lokacija
  • auction_location.facility_id
  • auction_location.matched_location_id — priskirtos inland shipping location ID
  • auction_location.match_score — similarity score, naudojamas matching
  • shipping.recommended_port
  • shipping.recommended_price_usd
  • shipping.has_shipping_price
  • shipping.available_ports — priskirtų uostų ir kainų sąrašas

7) Gauti shipping pagal VIN / loto numerį / slug

GET /shipping/auction-to-port

Grąžina shipping kainas nuo aukciono iki uosto be išankstinio vienos transporto priemonės endpoint iškvietimo.

Parametras Tipas Pavyzdys Aprašymas
vin string 1G1BC5SM7H7259061 Transporto VIN
lot_number string 12345678 Loto numeris
slug_vin string 2HKRM4H7XEH623608 arba 45416833 Transporto priemonės VIN arba aukciono loto numeris
ports string Miami,NY,LA Kableliais atskirtų paskirties uostų filtras

8) Gauti aukcionų lokacijas

GET /locations

Grąžina aukcionų facilities / biurus ir šiandienos aukcionų skaičių.

Parametras Tipas Pavyzdys Aprašymas
platform string copart Platformos filtras: copart arba iaai
state string FL Facility valstijos kodas
facility_id string 136 Facility ID
q string Birmingham Paieška pagal biuro pavadinimą, miestą, valstijos kodą arba ZIP
zip string 33166 ZIP/pašto kodas netoliese esantiems biurams ieškoti
radius number 50 Spindulys aplink ZIP/pašto kodą
units string mi Atstumo vienetai: km arba mi
per_page integer 50 Rezultatų skaičius puslapyje

Atsakyme yra:

  • platform
  • facility_id
  • name
  • name_desc
  • city
  • state_code
  • state_name
  • zip
  • latitude
  • longitude
  • location_url
  • sale_day
  • sale_time
  • time_zone
  • today_auction_count
  • distance kai naudojamas ZIP/radius search