AUTO-API.COM
Logo Copart

Copart APIScraper i parser

Copart API: loty aukcji online z aktualną ofertą, ceną Buy It Now, wyceną wartości i naprawy, uszkodzeniami i rodzajem dokumentu. Strumień ofert i pliki.

Oficjalne biblioteki SDK

Metody API są dostępne w naszych SDK jako gotowe funkcje, a otwarty kod bibliotek znajdziesz na GitHubie.

Copart API

Parser zbiera loty samochodów osobowych z internetowej aukcji samochodowej Copart w USA i Kanadzie. Przez API możesz śledzić oferty na potrzebne modele i filtrować loty według stanu lub prowincji, gdzie stoi auto. Nie trzeba uruchamiać własnego scrapera copart.com.

API

Przez /changes przychodzą nowe loty Copart, nowe oferty i loty wycofane ze sprzedaży.

Codzienne eksporty

Codzienny eksport zawiera loty Copart, które są w sprzedaży w dniu eksportu.

Pełne dane

Oferta i Buy It Now, szacunkowa wartość i koszt naprawy, rodzaj sprzedaży i data licytacji, uszkodzenia i dokument własności, kluczyki, zdjęcia z opisem ujęcia, panorama 360 i nagranie pracy silnika.

Uzyskaj dostęp do APIDostęp przyznany w ciągu 2 minut

Cena lotu to aktualna oferta. Buy It Now, szacunkowa wartość detaliczna i szacunkowy koszt naprawy przychodzą w osobnych polach.

Bazowy URL

https://{access_name}.auto-api.com/api/v3/copart

Autoryzacja: api_key parametr

Schemat integracji

1
/filterspobierz dostępne wartości filtrów
2

Pierwsze pobranie:

/change_id?date=...pobierz początkowe ID dla strumienia zmian
/offerspobierz wszystkie loty strona po stronie
3
/changes?change_id=...pobierz wszystkie zmiany w bazie danych od podanego ID
4
/offerpojedynczy lot według inner_id

Od czego zacząć:

1. Przed pierwszym pobraniem odczytaj z /change_id numer dla dzisiejszej daty i zapisz go. Następnie przejdź przez /offers strona po stronie aż do końca: na ostatniej stronie next_page ma wartość null.

2. Potem wywołaj /changes od tego numeru, a przy następnym żądaniu przekaż next_change_id z odpowiedzi. W ten sposób przychodzą nowe loty, nowe oferty i wycofania lotów ze sprzedaży. Jeśli next_change_id ma wartość null, nowych zdarzeń nie ma: powtórz żądanie później.

3. Aby wyszukiwać według własnych kryteriów, wywołuj /offers z filtrami.

Format danych

  • Typy są zachowane: liczba przychodzi jako liczba, lista jako tablica, brakująca wartość jako null.
  • Znaczniki czasu są w UTC, np. "2026-11-12T18:00:00Z". Strefa czasowa placu Copart przychodzi osobno w auction_timezone.
  • Aktualna oferta, cena Buy It Now i wartości szacunkowe są w walucie lotu: USD dla lotów z USA, CAD dla lotów z Kanady.
  • Wszystkie loty mają ten sam zestaw pól. Brakująca wartość przychodzi jako null, np. price dla lotu bez ofert. Puste listy przychodzą jako pusta tablica: photos dla lotu bez zdjęć, lot_features dla lotu bez oznaczeń.

GET/filters

Zwraca wszystkie możliwe wartości do filtrowania

https://{access_name}.auto-api.com/api/v3/copart/filters?api_key=YOUR_API_KEY

Odpowiedź:

{
  "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 strona po stronie, z filtrami lub bez.

Parametry:

  • page (wymagane) - numer strony
  • mark, model - marka i model, wartości z /filters, bez rozróżniania wielkości liter
  • transmission_type, color, body_type, engine_type, drive_type - skrzynia biegów, kolor, nadwozie, paliwo i napęd, wartości z /filters, bez rozróżniania wielkości liter
  • region - stan lub prowincja: nazwa z /filters albo kod Copart, np. "Texas" lub "TX"
  • year_from, year_to - rok od i do
  • km_age_from, km_age_to - przebieg w km od i do. Ten filtr pomija loty kanadyjskie
  • price_from, price_to - aktualna oferta od i do, w walucie lotu. Te filtry pomijają loty bez ofert

Aby przekazać do filtra kilka wartości, powtórz parametr z nawiasami kwadratowymi: 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

Odpowiedź:

{
  "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": {  // oryginalne wartości 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
      }
    }
    // ... pozostałe loty ze strony, do 20
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Pola danych:

Lot i cena

id - wewnętrzne ID bazy danych

inner_id - Numer lotu nadany przez Copart, ten sam co w linku do lotu. Po tym numerze lot pobiera się z /offer.

url - Strona lotu na copart.com.

price, currency - Aktualna oferta i waluta lotu, USD lub CAD. Bez ofert price ma wartość null. To nie jest cena sprzedaży: Copart jej nie publikuje.

buy_it_now_price - Cena Buy It Now, jeśli sprzedawca ją ustalił, w przeciwnym razie null.

estimated_retail_value - Szacunkowa wartość detaliczna auta według danych Copart.

repair_cost - Szacunkowy koszt naprawy według danych Copart, czasem z centami.

section - "Used" we wszystkich lotach.

description - Loty Copart nie mają opisu sprzedawcy, dlatego to pole ma zawsze wartość null.

created_at - Kiedy lot pojawił się w naszej bazie.

Auto

mark, model - Marka według słownika ("Hyundai", "Mercedes-Benz"), model tak, jak zapisuje go Copart, wielkimi literami ("SONATA").

complectation - Wersja wyposażenia tak, jak zapisuje ją Copart, np. "SE".

year - Rok modelowy.

first_registration - Copart nie publikuje daty pierwszej rejestracji, zawsze null.

vin - Maska VIN jak na stronie Copart: 11 znaków i gwiazdki. Auta wyprodukowane przed 1981 rokiem mają krótszy numer.

km_age - Przebieg w km w lotach z USA. W lotach kanadyjskich null.

odometer - Wskazanie licznika jak na stronie Copart, w lotach z USA w milach.

odometer_status - Status wskazania licznika: "Actual", "Not actual", "Exempt" lub "Exceeds mechanical limits".

owners_count - Copart nie publikuje liczby właścicieli, zawsze null.

Parametry techniczne

engine_type - Paliwo, np. "Gasoline", "Diesel", "Hybrid", "Electric" lub "Flex fuel".

transmission_type - "Automatic", "Manual" lub "None".

body_type - Typ nadwozia, np. "Sedan" lub "SUV".

drive_type - Napęd: "Front-wheel drive", "Rear-wheel drive", "All-wheel drive", "4x4" lub "4x2", gdy Copart nie podaje, która oś jest napędzana.

color - Kolor nadwozia.

displacement, displacement_cc - Pojemność silnika w litrach i w cm³. W autach elektrycznych null.

cylinders - Liczba cylindrów.

power, power_ice_hp, power_electro_kw, seat_count - Copart nie publikuje mocy ani liczby miejsc, dlatego te pola mają zawsze wartość null.

Stan i dokument własności

primary_damage, secondary_damage - Uszkodzenie główne i dodatkowe, np. "Front end" lub "Undercarriage".

condition - Stan auta po sprawdzeniu przez Copart: "Runs and drives", "Engine starts" lub "Enhanced vehicle".

has_keys - Kluczyki są (true) albo ich nie ma (false). Jeśli Copart tego nie podał, null.

title_type - Nazwa dokumentu własności tak, jak zapisuje ją Copart, wielkimi literami, np. "SALVAGE VEHICLE TITLE". Każdy stan ma własne nazwy.

title_group - Grupa dokumentu własności: "Clean title", "Salvage title" lub "Non-repairable".

title_state - Stan lub prowincja, gdzie wydano dokument własności.

Licytacja i lokalizacja

auction_at - Data i godzina licytacji w UTC. Dopóki termin licytacji nie zostanie wyznaczony, null.

auction_timezone - Strefa czasowa placu Copart, tak jak na stronie, np. "CST".

sale_type - Rodzaj sprzedaży: "Pure sale", "Minimum bid", "On approval" lub "Not on sale".

lot_features - Oznaczenia lotu jako lista, np. "Hot item", "No license required" lub "Hybrid". Dla lotu bez oznaczeń pusta tablica.

seller - Sprzedawca, jeśli Copart go pokazuje: zwykle firma ubezpieczeniowa lub dealer. W przeciwnym razie null.

seller_type, is_dealer, salon_id - Copart nie publikuje typu sprzedawcy, dlatego te pola mają zawsze wartość null.

country - "USA" lub "Canada".

region, city - Stan lub prowincja oraz miasto placu, na którym stoi auto.

zip - Kod pocztowy, w lotach z USA w postaci "77049-1968".

address - Plac Copart, na którym stoi auto, w zapisie ze strony: "TX - HOUSTON EAST".

latitude, longitude - Współrzędne tego placu Copart.

Zdjęcia, filmy i dane referencyjne

photos - Zdjęcia lotu w kolejności.

photo_details - Te same zdjęcia z nazwą ujęcia (type), np. "Front left", "Odometer" lub "Engine", i linkiem (url). Część lotów nie ma tych podpisów, wtedy null.

panorama_360 - Panorama 360: exterior zawiera po kolei klatki widoku dookoła auta, interior to sferyczne zdjęcie wnętrza lub null. Bez panoramy cały blok ma wartość null.

engine_video_url - Film z dźwiękiem pracującego silnika (mp4).

options - Copart nie publikuje wyposażenia, dlatego to pole ma zawsze wartość null.

original - Wartości głównych pól z copart.com przed tłumaczeniem.

catalog_ids - Kod marki używany przez Copart, np. "HYUN". Kodów modelu i wersji wyposażenia nie ma, więc tam jest null.

GET/change_id

Pobierz pierwsze ID zmiany według daty (do użycia w /changes)

Parametry:

  • date (wymagane) - data w formacie yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/copart/change_id?api_key=YOUR_API_KEY&date=2026-11-10

Odpowiedź:

{
  "change_id": 312400
}

Użyj zwróconej wartości jako parametru change_id w /changes

GET/changes

Strumień zmian (dodano/zmieniono/usunięto)

Parametry:

  • change_id (wymagane) - od którego ID zmiany
https://{access_name}.auto-api.com/api/v3/copart/changes?api_key=YOUR_API_KEY&change_id=312412

Odpowiedź:

{
  "result": [
    {
      "id": 312412,
      "inner_id": "61238556",
      "change_type": "changed",
      "created_at": "2026-11-10T04:21:15Z",
      "data": {  // nowa oferta w walucie lotu (null, jeśli nie ma już ofert)
        "new_price": 6600
      }
    },
    {
      "id": 312413,
      "inner_id": "74646926",
      "change_type": "added",
      "created_at": "2026-11-10T04:21:16Z",
      "data": { ... }  // pełne dane lotu, jak w /offers
    },
    {
      "id": 312414,
      "inner_id": "65737096",
      "change_type": "removed",
      "created_at": "2026-11-10T04:21:19Z",
      "data": {}  // lot wycofany ze sprzedaży
    }
    // ... dalej pozostałe zdarzenia, do 20 na stronie
  ],
  "meta": {
    "cur_change_id": 312412,
    "next_change_id": 312432,
    "limit": 20
  }
}

GET/offer

Pojedynczy lot według inner_id.

Parametry:

  • inner_id (wymagane)
https://{access_name}.auto-api.com/api/v3/copart/offer?api_key=YOUR_API_KEY&inner_id=45468636

Odpowiedź zawiera tylko obiekt data, bez opakowania w result.

Błędy

W razie błędu odpowiedź zawiera pole error z opisem: { "error": "parameter page is required" }

  • 401 - klucz api_key nie został przyjęty
  • 400 - brakuje wymaganego parametru lub wartość ma niewłaściwy format
  • 404 - nie ma lotu o takim inner_id (/offer)
  • 429 - limit żądań został wyczerpany

Przechowywanie

Pliki pozostają dostępne przez co najmniej 3 dni

Dostępność

Świeże pliki każdego ranka

Format CSV

Kolumny CSV są rozdzielone znakiem pipe (|)

Struktura URL:

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

Parametry:

  • access_name - Twoja osobista subdomena
  • date - data eksportu w formacie rrrr-mm-dd, np. 2026-11-10
  • file_name - nazwa pliku z rozszerzeniem

Dostępne pliki:

  • 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

Przykład żądania 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

Przykład polecenia Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
Copart

Copart (copart.com) prowadzi internetowe aukcje samochodowe, m.in. w USA i Kanadzie. Loty są rozłożone między place Copart, a każdy plac ma własny adres i strefę czasową licytacji. Auta wystawiają firmy ubezpieczeniowe, dealerzy, banki i wypożyczalnie samochodów.

Licytacja toczy się online: przed jej rozpoczęciem przyjmowane są oferty wstępne, a potem lot jest sprzedawany na wirtualnej licytacji na żywo. Sprzedaż może odbywać się bez ceny minimalnej, z ceną minimalną albo z akceptacją sprzedawcy, a część lotów ma cenę Buy It Now. Copart nie pokazuje odwiedzającym stronę pełnego VIN, historii ofert ani ceny sprzedaży.

Oznaczenie "No license required" wskazuje loty, na które można składać oferty bez licencji dealera. Na podstawie stanu, w którym jest plac, i jego współrzędnych oszacujesz dostawę auta do portu.

Nowe loty, nowe oferty i wycofania ze sprzedaży przychodzą przez /changes. Lot wycofany ze sprzedaży mógł zostać sprzedany albo zdjęty z aukcji.

Odpowiedź w 2 min