AUTO-API.COM
Лого на Copart

Copart APIScraper & Parser

Copart API: лотове от онлайн търг с текущо наддаване, Buy It Now, оценки на цената на дребно и ремонта, щети и вид на документа. Поток от наддавания и файлове.

Официални SDK библиотеки

Нашите SDK библиотеки включват методите на API-то като готови функции, а самите библиотеки са с отворен код в GitHub.

Copart API

Парсърът събира лотове с леки автомобили от Copart, онлайн търга за автомобили в САЩ и Канада. Чрез API можете да следите наддаванията за нужните ви модели и да подбирате лотове по щата, в който се намира автомобилът. Не ви трябва собствен скрейпър за copart.com.

API

Новите лотове в Copart, новите наддавания и свалените от продажба лотове идват чрез /changes.

Ежедневни експорти

Ежедневният експорт съдържа лотовете на Copart, които са в продажба към датата на експорта.

Пълни данни

Наддаване и Buy It Now, оценки на цената на дребно и на ремонта, вид на продажбата и дата на търга, щети и документ за собственост, ключове за автомобила, снимки с означен ракурс, панорама 360° и видео на двигателя.

Получете достъп до APIДостъпът се предоставя до 2 минути

Цената на лота е текущото наддаване. Buy It Now, оценката на цената на дребно и оценката на стойността на ремонта идват в отделни полета.

Базов URL

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

Оторизация: api_key параметър

Ред на работа

1
/filtersполучаване на наличните стойности на филтрите
2

Първоначално зареждане:

/change_id?date=...получаване на началното ID за потока от промени
/offersизтегляне на всички лотове страница по страница
3
/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID
4
/offerотделен лот по inner_id

Откъде да започнете:

1. Преди първото зареждане вземете номера от /change_id за днешната дата и го запазете. След това преминете през /offers страница по страница до края: на последната страница next_page е null.

2. След това извиквайте /changes от този номер, а следващия път подавайте next_change_id от отговора. Така идват новите лотове, новите наддавания и свалянето на лотове от продажба. Ако next_change_id е null, нови събития няма: повторете заявката по-късно.

3. За да търсите по собствени критерии, извиквайте /offers с филтри.

Формат на данните

  • Типовете се запазват: числото идва като число, списъкът като масив, а липсващата стойност като null.
  • Датата и часът се дават в UTC, например "2026-11-12T18:00:00Z". Часовата зона на площадката на Copart идва отделно в auction_timezone.
  • Наддаването, Buy It Now и оценките са във валутата на лота: USD за лотовете от САЩ, CAD за лотовете от Канада.
  • Наборът от полета е еднакъв за всички лотове. Липсващата стойност идва като null, например price при лот без наддавания. Празните списъци идват като празен масив: photos при лот без снимки, lot_features при лот без етикети.

GET/filters

Връща всички възможни стойности за филтриране

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

Отговор:

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

Лотове страница по страница, с филтри или без.

Параметри:

  • page (задължително) - номер на страницата
  • mark, model - марка и модел, стойности от /filters, без разлика между главни и малки букви
  • transmission_type, color, body_type, engine_type, drive_type - скоростна кутия, цвят, каросерия, гориво и задвижване, стойности от /filters, без разлика между главни и малки букви
  • region - щат или провинция по името от /filters или по кода в Copart, например "Texas" или "TX"
  • year_from, year_to - година от и до
  • km_age_from, km_age_to - пробег в км от и до. Канадските лотове не отговарят на този филтър
  • price_from, price_to - текущо наддаване от и до, във валутата на лота. Лотовете без наддавания не отговарят на тези филтри

За да подадете няколко стойности на един филтър, повторете параметъра със скоби: 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

Отговор:

{
  "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": {  // оригинални стойности от 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
      }
    }
    // ... останалите лотове от страницата, до 20
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Полета с данни:

Лот и цена

id - вътрешно ID в базата данни

inner_id - Номер на лота в Copart, същият като във връзката към лота. С него получавате лота от /offer.

url - Страница на лота в copart.com.

price, currency - Текущо наддаване и валута на лота, USD или CAD. Без наддавания price е null. Това не е продажната цена: Copart не я публикува.

buy_it_now_price - Цена Buy It Now, ако продавачът е определил такава, иначе null.

estimated_retail_value - Оценка на цената на дребно за автомобила според Copart.

repair_cost - Оценка на стойността на ремонта според Copart, понякога с центове.

section - При всички лотове е "Used".

description - Лотовете в Copart нямат описание от продавача, затова полето винаги е null.

created_at - Кога лотът се е появил в нашата база данни.

Автомобил

mark, model - Марка според справочника ("Hyundai", "Mercedes-Benz"), модел така, както го изписва Copart, с главни букви ("SONATA").

complectation - Ниво на оборудване, както го изписва Copart, например "SE".

year - Моделна година.

first_registration - Copart не публикува датата на първа регистрация, полето винаги е null.

vin - Маска на VIN, както в Copart: 11 знака и звездички. При автомобилите, произведени преди 1981 г., номерът е по-къс.

km_age - Пробег в км при лотовете от САЩ. При канадските лотове е null.

odometer - Показание на одометъра, както в Copart, при лотовете от САЩ в мили.

odometer_status - Статус на показанието: "Actual", "Not actual", "Exempt" или "Exceeds mechanical limits".

owners_count - Copart не публикува броя на собствениците, полето винаги е null.

Характеристики

engine_type - Гориво, например "Gasoline", "Diesel", "Hybrid", "Electric" или "Flex fuel".

transmission_type - "Automatic", "Manual" или "None".

body_type - Тип каросерия, например "Sedan" или "SUV".

drive_type - Задвижване: "Front-wheel drive", "Rear-wheel drive", "All-wheel drive", "4x4" или "4x2", когато Copart не уточнява коя ос е задвижваща.

color - Цвят на каросерията.

displacement, displacement_cc - Обем на двигателя в литри и в куб. см. При електромобилите е null.

cylinders - Брой цилиндри.

power, power_ice_hp, power_electro_kw, seat_count - Copart не публикува мощността и броя на местата, затова тези полета винаги са null.

Състояние и документ за собственост

primary_damage, secondary_damage - Основна и допълнителна щета, например "Front end" или "Undercarriage".

condition - Състояние според проверката на Copart: "Runs and drives", "Engine starts" или "Enhanced vehicle".

has_keys - Има ключове за автомобила (true) или няма (false). null, ако Copart не го е посочил.

title_type - Наименование на документа за собственост, както го изписва Copart, с главни букви, например "SALVAGE VEHICLE TITLE". Всеки щат има свои наименования.

title_group - Група на документа: "Clean title", "Salvage title" или "Non-repairable".

title_state - Щат или провинция на издаване на документа.

Търг и местоположение

auction_at - Дата и час на търга в UTC. null, докато търгът не бъде насрочен.

auction_timezone - Часова зона на площадката на Copart, както е посочена на сайта, например "CST".

sale_type - Вид на продажбата: "Pure sale", "Minimum bid", "On approval" или "Not on sale".

lot_features - Етикети на лота като списък, например "Hot item", "No license required" или "Hybrid". При лот без етикети е празен масив.

seller - Продавач, ако Copart го показва: обикновено застрахователна компания или дилър. Иначе null.

seller_type, is_dealer, salon_id - Copart не публикува типа на продавача, затова тези полета винаги са null.

country - "USA" или "Canada".

region, city - Щат или провинция и град на площадката, където се намира автомобилът.

zip - Пощенски код, при лотовете от САЩ във вида "77049-1968".

address - Площадката на Copart, където се намира автомобилът, както е посочена на сайта: "TX - HOUSTON EAST".

latitude, longitude - Координати на тази площадка на Copart.

Снимки, видеа и справочни данни

photos - Снимките на лота по ред.

photo_details - Същите снимки с ракурса (type), например "Front left", "Odometer" или "Engine", и връзката (url). При някои лотове ракурсът не е означен и полето е null.

panorama_360 - Панорама 360°: exterior съдържа кадрите от обиколката около автомобила по ред, interior е сферична снимка на интериора или null. Ако няма панорама, целият блок е null.

engine_video_url - Видео със звука на работещия двигател (mp4).

options - Copart не публикува оборудването, затова полето винаги е null.

original - Стойностите на основните полета от copart.com преди превода.

catalog_ids - Код на марката в Copart, например "HYUN". Кодове на модела и на нивото на оборудване няма, затова тези стойности са null.

GET/change_id

Получаване на първото ID на промяна по дата (за използване в /changes)

Параметри:

  • date (задължително) - дата във формат yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/copart/change_id?api_key=YOUR_API_KEY&date=2026-11-10

Отговор:

{
  "change_id": 312400
}

Използвайте върнатата стойност като параметър change_id в /changes

GET/changes

Поток от промени (добавени/променени/премахнати)

Параметри:

  • change_id (задължително) - от кое ID на промяна да се започне
https://{access_name}.auto-api.com/api/v3/copart/changes?api_key=YOUR_API_KEY&change_id=312412

Отговор:

{
  "result": [
    {
      "id": 312412,
      "inner_id": "61238556",
      "change_type": "changed",
      "created_at": "2026-11-10T04:21:15Z",
      "data": {  // ново наддаване във валутата на лота (null, ако не са останали наддавания)
        "new_price": 6600
      }
    },
    {
      "id": 312413,
      "inner_id": "74646926",
      "change_type": "added",
      "created_at": "2026-11-10T04:21:16Z",
      "data": { ... }  // цялото тяло на лота, както в /offers
    },
    {
      "id": 312414,
      "inner_id": "65737096",
      "change_type": "removed",
      "created_at": "2026-11-10T04:21:19Z",
      "data": {}  // лотът е свален от продажба
    }
    // ... следват останалите събития, до 20 на страница
  ],
  "meta": {
    "cur_change_id": 312412,
    "next_change_id": 312432,
    "limit": 20
  }
}

GET/offer

Отделен лот по inner_id.

Параметри:

  • inner_id (задължително)
https://{access_name}.auto-api.com/api/v3/copart/offer?api_key=YOUR_API_KEY&inner_id=45468636

Отговорът съдържа само обекта data, без обвивката result.

Грешки

При грешка отговорът съдържа поле error с описание: { "error": "parameter page is required" }

  • 401 - ключът api_key не е приет
  • 400 - липсва задължителен параметър или някоя стойност е в неправилен формат
  • 404 - няма лот с такъв inner_id (/offer)
  • 429 - лимитът на заявките е изчерпан

Съхранение

Файловете остават достъпни поне 3 дни

Достъпност

Нови файлове всяка сутрин

CSV формат

Колоните в CSV са разделени с вертикална черта (|)

Структура на URL адреса:

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

Параметри:

  • access_name - вашият личен поддомейн
  • date - дата на експорта във формат yyyy-mm-dd, напр. 2026-11-10
  • file_name - име на файла с разширението

Налични файлове:

  • 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

Примерна заявка с 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

Примерна команда с Wget

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

Copart (copart.com) провежда онлайн търгове за автомобили, включително в САЩ и Канада. Лотовете са разпределени по площадките на Copart, всяка със свой адрес и часова зона на търговете. Автомобилите се предлагат от застрахователни компании, дилъри, банки и фирми за автомобили под наем.

Наддаването е онлайн: преди началото се приемат предварителни наддавания, след което лотът се продава на виртуален търг на живо. Продажбата може да е без минимална цена, с минимална цена или с одобрение от продавача, а някои лотове имат цена Buy It Now. Copart не показва на посетителите на сайта пълния VIN, историята на наддаванията или продажната цена.

Етикетът "No license required" отбелязва лотовете, за които не ви е нужен дилърски лиценз, за да наддавате. По щата и координатите на площадката можете да прецените приблизително доставката до пристанището.

Новите лотове, новите наддавания и свалянето от продажба идват чрез /changes. Свален от продажба лот може да е продаден или оттеглен.

Отговор до 2 мин