
Copart APIScraper a parser
Copart API: loty online aukce, aktuální příhoz, Buy It Now, odhad maloobchodní hodnoty a opravy, poškození a typ dokladu o vlastnictví. Feed příhozů a soubory.
Copart API
Parser sbírá loty osobních vozů z online autoaukce Copart v USA a Kanadě. Přes API můžete sledovat příhozy u modelů, které hledáte, a vybírat loty podle státu, kde vůz stojí. Vlastní scraper pro copart.com provozovat nemusíte.
Přes /changes přicházejí nové loty Copart, nové příhozy a loty stažené z prodeje.
Denní export obsahuje loty Copart, které jsou k datu exportu v prodeji.
Příhoz a Buy It Now, odhady hodnoty a nákladů na opravu, typ prodeje a datum dražby, poškození a doklad o vlastnictví, klíče od vozu, fotky s úhlem záběru, panorama 360° a video motoru.
Cenou lotu je aktuální příhoz. Buy It Now, odhad maloobchodní hodnoty a odhad nákladů na opravu přicházejí v samostatných polích.
Základní URL
https://{access_name}.auto-api.com/api/v3/copartAutorizace: api_key parametr
Pracovní postup
/filterszískat dostupné hodnoty filtrůPrvní načtení:
/change_id?date=...získat počáteční ID pro stream změn/offersstáhnout všechny loty po stránkách/changes?change_id=...získat všechny změny v databázi od daného ID/offerjednotlivý lot podle inner_idKde začít:
1. Před prvním načtením zjistěte z /change_id číslo pro dnešní datum a uložte si ho. Potom projděte /offers stránku po stránce až do konce: na poslední stránce má next_page hodnotu null.
2. Pak načtěte /changes od tohoto čísla a při dalším požadavku předejte next_change_id z odpovědi. Tímto způsobem přicházejí nové loty, nové příhozy a stažení lotů z prodeje. Pokud má next_change_id hodnotu null, nové události nejsou: zopakujte požadavek později.
3. Pro vyhledávání podle vlastních kritérií volejte /offers s filtry.
Formát dat
- Datové typy se zachovávají: číslo přichází jako číslo, seznam jako pole, chybějící hodnota jako null.
- Časová razítka jsou uvedena v UTC, například "2026-11-12T18:00:00Z". Časové pásmo areálu Copart přichází zvlášť v auction_timezone.
- Příhoz, cena Buy It Now a odhady se uvádějí v měně lotu: u amerických lotů USD, u kanadských CAD.
- Všechny loty mají stejnou sadu polí. Chybějící hodnota přichází jako null, například price u lotu bez příhozů. Prázdný seznam přichází jako prázdné pole: photos u lotu bez fotek, lot_features u lotu bez štítků.
GET/filters
Vrací všechny možné hodnoty pro filtrování
https://{access_name}.auto-api.com/api/v3/copart/filters?api_key=YOUR_API_KEYOdpověď:
{
"mark": {
"Chevrolet": { "model": [..., "TAHOE", "TAHOE 1500", "TAHOE 4D LT", "TAHOE C1500", ...] },
"Hyundai": { "model": [..., "SONATA", "SONATA 2.0T SE/LTD", "SONATA GLS", ...] },
"Toyota": { "model": [..., "RAV4", "RAV4 AUTOMATIC 4WD", "RAV4 EV", "RAV4 HV", ...] },
...
},
"transmission_type": ["Automatic", "Manual", "None"],
"color": [..., "Beige", "Black", "BLK", "Blue", ...],
"body_type": [..., "Convertible", "Coupe", "CREW CHA", ...],
"engine_type": ["CNG", ..., "Diesel", "Electric", "Flex fuel", "Gasoline", "Hybrid", "Hydrogen"],
"drive_type": ["4x2", "4x4", "All-wheel drive", "Front-wheel drive", "Rear-wheel drive"],
"region": ["Alabama", "Alaska", "Alberta", "Arizona", ...]
}GET/offers
Loty po stránkách, s filtry nebo bez nich.
Parametry:
page(povinné) - číslo stránkymark, model- značka a model, hodnoty z /filters, bez rozlišení velikosti písmentransmission_type, color, body_type, engine_type, drive_type- převodovka, barva, karoserie, palivo a pohon, hodnoty z /filters, na velikosti písmen nezáležíregion- stát nebo provincie: název z /filters nebo kód, který používá Copart, například "Texas" nebo "TX"year_from, year_to- rok od a dokm_age_from, km_age_to- nájezd v km od a do. Loty z Kanady tento filtr nenajdeprice_from, price_to- aktuální příhoz od a do v měně lotu. Loty bez příhozů s těmito filtry nepřicházejí
Chcete-li do filtru předat více hodnot, zopakujte parametr s hranatými závorkami: mark[]=Hyundai&mark[]=Kia
https://{access_name}.auto-api.com/api/v3/copart/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/copart/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&model=SONATA&year_from=2020https://{access_name}.auto-api.com/api/v3/copart/offers?api_key=YOUR_API_KEY&page=1®ion=Texas&price_to=3000Odpověď:
{
"result": [
{
"id": 73519,
"inner_id": "45468636",
"change_type": "added",
"created_at": "2026-10-24T12:04:43Z",
"data": {
"id": 73519,
"inner_id": "45468636",
"url": "https://www.copart.com/lot/45468636/salvage-2021-hyundai-sonata-se-tx-houston-east",
"mark": "Hyundai",
"model": "SONATA",
"complectation": "SE",
"year": 2021,
"first_registration": null,
"km_age": 170309,
"odometer": 105825,
"odometer_status": "Actual",
"owners_count": null,
"price": 900,
"currency": "USD",
"buy_it_now_price": 2500,
"estimated_retail_value": 11200,
"repair_cost": 27596.5,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "Sedan",
"drive_type": "Front-wheel drive",
"color": "Blue",
"displacement": 2.5,
"displacement_cc": 2500,
"cylinders": 4,
"power": null,
"power_ice_hp": null,
"power_electro_kw": null,
"seat_count": null,
"section": "Used",
"seller_type": null,
"is_dealer": null,
"salon_id": null,
"seller": null,
"region": "Texas",
"city": "Houston",
"zip": "77049-1968",
"country": "USA",
"address": "TX - HOUSTON EAST",
"latitude": 29.85146,
"longitude": -95.15938,
"description": null,
"created_at": "2026-10-24T12:04:43Z",
"auction_at": "2026-11-12T18:00:00Z",
"auction_timezone": "CST",
"sale_type": "Minimum bid",
"condition": "Runs and drives",
"primary_damage": "Front end",
"secondary_damage": null,
"has_keys": true,
"title_type": "SALVAGE VEHICLE TITLE",
"title_group": "Salvage title",
"title_state": "Texas",
"lot_features": ["Hot item", "No license required"],
"photos": [
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/0da3a7d668234168bb57f702dd5fde62_hrs.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/d7bc5c3c7e154bd892aafccf6cf2e94e_hrs.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/a4886b15006f46fb874d1887c8ac789f_hrs.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/be3e06d1d70b498787070e0e498e2606_hrs.jpg",
...
],
"photo_details": [
{
"type": "Front left",
"url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/0da3a7d668234168bb57f702dd5fde62_hrs.jpg"
},
{
"type": "Rear left",
"url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/d7bc5c3c7e154bd892aafccf6cf2e94e_hrs.jpg"
},
{
"type": "Rear right",
"url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/a4886b15006f46fb874d1887c8ac789f_hrs.jpg"
},
{
"type": "Front right",
"url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/be3e06d1d70b498787070e0e498e2606_hrs.jpg"
},
...
],
"panorama_360": {
"exterior": [
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/5738904f37ef49adbec9c4656ccec4fe_frames_0.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/5738904f37ef49adbec9c4656ccec4fe_frames_1.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/5738904f37ef49adbec9c4656ccec4fe_frames_2.jpg",
"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/5738904f37ef49adbec9c4656ccec4fe_frames_3.jpg",
...
],
"interior": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/8ab2aa4018fa454b9965457c31763c77_O.jpeg"
},
"engine_video_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0326/d47a3ed97b4d4aa6a4b6e0321acdf582_O.mp4",
"vin": "5NPEG4JA0MH******",
"original": { // původní hodnoty z copart.com
"mark": "HYUNDAI",
"model": "SONATA",
"complectation": "SE",
"engine_type": "GAS",
"transmission_type": "AUTOMATIC",
"body_type": "SEDAN",
"drive_type": "FRONT WHEEL DRIVE",
"color": "BLUE",
"region": "TX",
"city": "HOUSTON",
"country": "USA",
"odometer_status": "ACTUAL",
"sale_type": "Minimum Bid",
"condition": "RUNS AND DRIVES",
"primary_damage": "FRONT END",
"secondary_damage": null,
"title_group": "SALVAGE TITLE",
"title_state": "TX",
"lot_features": ["Hot Items", "No License Required"]
},
"catalog_ids": {
"mark": "HYUN",
"model": null,
"complectation": null
},
"options": null
}
}
// ... ostatní loty stránky, nejvýše 20
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Datová pole:
Lot a cena
id - interní ID databáze
inner_id - Číslo lotu Copart, stejné jako v odkazu na lot. Podle něj lot načtete přes /offer.
url - Stránka lotu na copart.com.
price, currency - Aktuální příhoz a měna lotu, USD nebo CAD. Bez příhozů je price null. Nejde o prodejní cenu: tu Copart nezveřejňuje.
buy_it_now_price - Cena Buy It Now, pokud ji prodejce stanovil, jinak null.
estimated_retail_value - Odhad maloobchodní hodnoty vozu, jak ho uvádí Copart.
repair_cost - Odhad nákladů na opravu, jak ho uvádí Copart, někdy i s centy.
section - U všech lotů "Used".
description - Loty Copart nemají popis od prodejce, proto má toto pole vždy hodnotu null.
created_at - Kdy se lot objevil v naší databázi.
Vůz
mark, model - Značka podle číselníku ("Hyundai", "Mercedes-Benz"), model tak, jak ho píše Copart, velkými písmeny ("SONATA").
complectation - Výbavová verze tak, jak ji píše Copart, například "SE".
year - Modelový rok.
first_registration - Datum první registrace Copart nezveřejňuje, vždy null.
vin - Maska VIN v podobě, jakou ukazuje Copart: 11 znaků a hvězdičky. Vozy vyrobené před rokem 1981 mají kratší číslo.
km_age - Nájezd v km u lotů z USA. U kanadských lotů null.
odometer - Údaj tachometru tak, jak ho uvádí Copart, u lotů z USA v mílích.
odometer_status - Status údaje tachometru: "Actual", "Not actual", "Exempt" nebo "Exceeds mechanical limits".
owners_count - Počet majitelů Copart nezveřejňuje, vždy null.
Technické údaje
engine_type - Palivo, například "Gasoline", "Diesel", "Hybrid", "Electric" nebo "Flex fuel".
transmission_type - "Automatic", "Manual" nebo "None".
body_type - Typ karoserie, například "Sedan" nebo "SUV".
drive_type - Pohon: "Front-wheel drive", "Rear-wheel drive", "All-wheel drive", "4x4" nebo "4x2", když Copart neuvádí, která náprava je hnací.
color - Barva karoserie.
displacement, displacement_cc - Zdvihový objem motoru v litrech a v cm³. U elektromobilů null.
cylinders - Počet válců.
power, power_ice_hp, power_electro_kw, seat_count - Výkon ani počet míst Copart nezveřejňuje, proto mají tato pole vždy hodnotu null.
Stav a doklad o vlastnictví
primary_damage, secondary_damage - Hlavní a vedlejší poškození, například "Front end" nebo "Undercarriage".
condition - Stav zjištěný při kontrole, kterou provádí Copart: "Runs and drives", "Engine starts" nebo "Enhanced vehicle".
has_keys - Klíče od vozu jsou k dispozici (true), nebo nejsou (false). Pokud to Copart neuvedl, null.
title_type - Název dokladu o vlastnictví tak, jak ho píše Copart, velkými písmeny, například "SALVAGE VEHICLE TITLE". Každý stát má vlastní názvy.
title_group - Skupina dokladu o vlastnictví: "Clean title", "Salvage title" nebo "Non-repairable".
title_state - Stát nebo provincie, kde byl doklad vydán.
Dražba a místo
auction_at - Datum a čas dražby v UTC. Dokud dražba není naplánována, null.
auction_timezone - Časové pásmo areálu Copart podle údaje na copart.com, například "CST".
sale_type - Typ prodeje: "Pure sale", "Minimum bid", "On approval" nebo "Not on sale".
lot_features - Seznam štítků lotu, například "Hot item", "No license required" nebo "Hybrid". U lotu bez štítků prázdné pole.
seller - Prodejce, pokud ho Copart ukazuje: obvykle pojišťovna nebo dealer. Jinak null.
seller_type, is_dealer, salon_id - Typ prodejce Copart nezveřejňuje, proto mají tato pole vždy hodnotu null.
country - "USA" nebo "Canada".
region, city - Stát nebo provincie a město areálu, kde vůz stojí.
zip - PSČ, u lotů z USA ve tvaru "77049-1968".
address - Areál Copart, kde vůz stojí, tak, jak je uveden na copart.com: "TX - HOUSTON EAST".
latitude, longitude - Souřadnice tohoto areálu Copart.
Fotky, videa a referenční údaje
photos - Fotky lotu popořadě.
photo_details - Tytéž fotky s úhlem záběru (type), například "Front left", "Odometer" nebo "Engine", a s odkazem (url). U části lotů popisky chybějí, pak je hodnota null.
panorama_360 - Panorama 360°: v exterior jsou popořadě snímky obchůzky kolem vozu, interior je sférický snímek interiéru nebo null. Bez panoramatu je celý blok null.
engine_video_url - Video se zvukem běžícího motoru (mp4).
options - Výbavu Copart nezveřejňuje, proto má toto pole vždy hodnotu null.
original - Hodnoty hlavních polí z copart.com před překladem.
catalog_ids - Kód značky, který používá Copart, například "HYUN". Kódy modelu a výbavové verze nejsou, proto je tam null.
GET/change_id
Získat první ID změny podle data (pro použití v /changes)
Parametry:
date(povinné) - datum ve formátu yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/copart/change_id?api_key=YOUR_API_KEY&date=2026-11-10Odpověď:
{
"change_id": 312400
}Použijte vrácenou hodnotu jako parametr change_id v /changes
GET/changes
Stream změn (přidáno/změněno/odstraněno)
Parametry:
change_id(povinné) - od kterého ID změny
https://{access_name}.auto-api.com/api/v3/copart/changes?api_key=YOUR_API_KEY&change_id=312412Odpověď:
{
"result": [
{
"id": 312412,
"inner_id": "61238556",
"change_type": "changed",
"created_at": "2026-11-10T04:21:15Z",
"data": { // nový příhoz v měně lotu (null, pokud žádné příhozy nezůstaly)
"new_price": 6600
}
},
{
"id": 312413,
"inner_id": "74646926",
"change_type": "added",
"created_at": "2026-11-10T04:21:16Z",
"data": { ... } // celé tělo lotu jako v /offers
},
{
"id": 312414,
"inner_id": "65737096",
"change_type": "removed",
"created_at": "2026-11-10T04:21:19Z",
"data": {} // lot stažen z prodeje
}
// ... dále ostatní události, až 20 na stránce
],
"meta": {
"cur_change_id": 312412,
"next_change_id": 312432,
"limit": 20
}
}GET/offer
Jednotlivý lot podle inner_id.
Parametry:
inner_id(povinné)
https://{access_name}.auto-api.com/api/v3/copart/offer?api_key=YOUR_API_KEY&inner_id=45468636Odpověď obsahuje jen objekt data, bez obalu result.
Chyby
Při chybě obsahuje odpověď pole error s popisem: { "error": "parameter page is required" }
401- klíč api_key nebyl přijat400- chybí povinný parametr nebo má hodnota nesprávný formát404- lot s tímto inner_id neexistuje (/offer)429- limit požadavků je vyčerpán
Uchování
Soubory zůstávají dostupné nejméně 3 dny
Dostupnost
Nové soubory každé ráno
Formát CSV
Sloupce CSV jsou odděleny znakem svislítko (|)
Struktura URL:
Parametry:
access_name- vaše osobní subdoménadate- datum exportu ve formátu rrrr-mm-dd, např. 2026-11-10file_name- název souboru s příponou
Dostupné soubory:
- CSV - all_active.csv, new_daily.csv, removed_daily.csv
- JSON - all_active.json, new_daily.json, removed_daily.json
- Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx
Příklad požadavku cURL
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvPříklad příkazu Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Copart (copart.com) pořádá online aukce aut, mimo jiné v USA a Kanadě. Loty jsou rozmístěné po areálech Copart, každý má vlastní adresu a časové pásmo dražby. Vozy do aukcí dávají pojišťovny, dealeři, banky a autopůjčovny.
Přihazuje se online: před začátkem se přijímají předběžné příhozy, potom se lot prodává v živé virtuální dražbě. Prodej může probíhat bez minimální ceny, s minimálním příhozem nebo se schválením prodejce a část lotů má cenu Buy It Now. Úplný VIN, historii příhozů ani prodejní cenu Copart návštěvníkům webu neukazuje.
Štítek "No license required" označuje loty, u kterých k přihazování nepotřebujete dealerskou licenci. Podle státu a souřadnic areálu lze odhadnout dopravu do přístavu.
Přes /changes přicházejí nové loty, nové příhozy a stažení z prodeje. Lot stažený z prodeje mohl být prodán, ale také odvolán z aukce.
Automobilová data z různých světových trhů s našimi platformovými API: