AUTO-API.COM
Logo Copart

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.

Oficiální SDK knihovny

Metody API najdete v našich SDK jako hotové funkce, knihovny jsou open source na GitHubu.

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.

API

Přes /changes přicházejí nové loty Copart, nové příhozy a loty stažené z prodeje.

Denní exporty

Denní export obsahuje loty Copart, které jsou k datu exportu v prodeji.

Kompletní data

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.

Získat přístup k APIPřístup poskytnut do 2 minut

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/copart

Autorizace: api_key parametr

Pracovní postup

1
/filterszískat dostupné hodnoty filtrů
2

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
3
/changes?change_id=...získat všechny změny v databázi od daného ID
4
/offerjednotlivý lot podle inner_id

Kde 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_KEY

Odpověď:

{
  "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ánky
  • mark, model - značka a model, hodnoty z /filters, bez rozlišení velikosti písmen
  • transmission_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 do
  • km_age_from, km_age_to - nájezd v km od a do. Loty z Kanady tento filtr nenajde
  • price_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&region=Texas&price_to=3000

Odpověď:

{
  "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-10

Odpověď:

{
  "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=312412

Odpověď:

{
  "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=45468636

Odpověď 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řijat
  • 400 - chybí povinný parametr nebo má hodnota nesprávný formát
  • 404 - 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:

https://{access_name}.auto-api.com/{date}/{file_name}

Parametry:

  • access_name - vaše osobní subdoména
  • date - datum exportu ve formátu rrrr-mm-dd, např. 2026-11-10
  • file_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.csv

Pří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 (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.

Odpovíme do 2 minut