
Copart APIScraper & Parser
Copart API: лотове от онлайн търг с текущо наддаване, Buy It Now, оценки на цената на дребно и ремонта, щети и вид на документа. Поток от наддавания и файлове.
Copart API
Парсърът събира лотове с леки автомобили от Copart, онлайн търга за автомобили в САЩ и Канада. Чрез API можете да следите наддаванията за нужните ви модели и да подбирате лотове по щата, в който се намира автомобилът. Не ви трябва собствен скрейпър за copart.com.
Новите лотове в Copart, новите наддавания и свалените от продажба лотове идват чрез /changes.
Ежедневният експорт съдържа лотовете на Copart, които са в продажба към датата на експорта.
Наддаване и Buy It Now, оценки на цената на дребно и на ремонта, вид на продажбата и дата на търга, щети и документ за собственост, ключове за автомобила, снимки с означен ракурс, панорама 360° и видео на двигателя.
Цената на лота е текущото наддаване. Buy It Now, оценката на цената на дребно и оценката на стойността на ремонта идват в отделни полета.
Базов URL
https://{access_name}.auto-api.com/api/v3/copartОторизация: api_key параметър
Ред на работа
/filtersполучаване на наличните стойности на филтритеПървоначално зареждане:
/change_id?date=...получаване на началното ID за потока от промени/offersизтегляне на всички лотове страница по страница/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID/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®ion=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 адреса:
Параметри:
access_name- вашият личен поддомейнdate- дата на експорта във формат yyyy-mm-dd, напр. 2026-11-10file_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.com) провежда онлайн търгове за автомобили, включително в САЩ и Канада. Лотовете са разпределени по площадките на Copart, всяка със свой адрес и часова зона на търговете. Автомобилите се предлагат от застрахователни компании, дилъри, банки и фирми за автомобили под наем.
Наддаването е онлайн: преди началото се приемат предварителни наддавания, след което лотът се продава на виртуален търг на живо. Продажбата може да е без минимална цена, с минимална цена или с одобрение от продавача, а някои лотове имат цена Buy It Now. Copart не показва на посетителите на сайта пълния VIN, историята на наддаванията или продажната цена.
Етикетът "No license required" отбелязва лотовете, за които не ви е нужен дилърски лиценз, за да наддавате. По щата и координатите на площадката можете да прецените приблизително доставката до пристанището.
Новите лотове, новите наддавания и свалянето от продажба идват чрез /changes. Свален от продажба лот може да е продаден или оттеглен.
Разширете покритието на автомобилните си данни по световните пазари с нашите API за отделните платформи: