
Copart APIScraper & Parser
Copart API: lote ankandi online me ofertë aktuale, Buy It Now, vlerësim të vlerës me pakicë e riparimit, dëmtime, certifikatë pronësie. Fluks ofertash, skedarë.
Copart API
Parser-i mbledh lote autoveturash nga Copart, ankandi online i makinave, në SHBA dhe Kanada. Me API-në mund të ndiqni ofertat për modelet që ju duhen dhe t'i filtroni lotet sipas shtetit ku ndodhet makina. Nuk ju duhet të mbani vetë një scraper për copart.com.
Lotet e reja të Copart, ofertat e reja dhe lotet e hequra nga shitja vijnë përmes /changes.
Eksportimi ditor përmban lotet e Copart që janë në shitje në datën e eksportimit.
Oferta dhe Buy It Now, vlerësimet e vlerës dhe të riparimit, lloji i shitjes dhe data e ankandit, dëmtimet dhe certifikata e pronësisë, çelësat e makinës, fotot me etiketat e këndit, panorama 360 dhe videoja e motorit.
Çmimi i lotit është oferta aktuale. Buy It Now, vlera e vlerësuar me pakicë dhe kostoja e vlerësuar e riparimit vijnë në fusha të veçanta.
URL bazë
https://{access_name}.auto-api.com/api/v3/copartAutorizimi: api_key parametër
Rrjedha e punës
/filtersmerrni vlerat e disponueshme të filtraveNgarkimi fillestar:
/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve/offersshkarkoni të gjitha lotet faqe pas faqeje/changes?change_id=...merrni të gjitha ndryshimet në bazën e të dhënave duke filluar nga ID-ja/offernjë lot i vetëm sipas inner_idSi të filloni:
1. Para ngarkimit të parë, merrni numrin nga /change_id për datën e sotme dhe ruajeni. Pastaj kaloni nëpër /offers faqe pas faqeje deri në fund: në faqen e fundit next_page është null.
2. Pastaj thirrni /changes duke filluar nga ky numër, dhe herën tjetër dërgoni next_change_id nga përgjigjja. Kështu vijnë lotet e reja, ofertat e reja dhe heqjet e loteve nga shitja. Nëse next_change_id është null, nuk ka ngjarje të reja: përsëritni kërkesën më vonë.
3. Për të kërkuar sipas kritereve tuaja, thirrni /offers me filtra.
Formati i të dhënave
- Llojet e të dhënave ruhen: një numër vjen si numër, një listë si varg, një vlerë që mungon si null.
- Vulat kohore janë në UTC, për shembull "2026-11-12T18:00:00Z". Zona kohore e sheshit të Copart vjen veçmas në auction_timezone.
- Oferta, Buy It Now dhe vlerësimet janë në monedhën e lotit: USD për lotet në SHBA, CAD për lotet në Kanada.
- Të gjitha lotet kanë të njëjtin grup fushash. Një vlerë që mungon vjen si null, për shembull price për një lot pa oferta. Listat bosh vijnë si varg bosh: photos për një lot pa foto, lot_features për një lot pa etiketa.
GET/filters
Kthen të gjitha vlerat e mundshme për filtrim
https://{access_name}.auto-api.com/api/v3/copart/filters?api_key=YOUR_API_KEYPërgjigjja:
{
"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
Lotet faqe pas faqeje, me ose pa filtra.
Parametrat:
page(i detyrueshëm) - numri i faqesmark, model- marka dhe modeli, vlera nga /filters, pa dallim midis shkronjave të mëdha dhe të voglatransmission_type, color, body_type, engine_type, drive_type- transmisioni, ngjyra, karroceria, karburanti dhe tërheqja, vlera nga /filters, pa dallim midis shkronjave të mëdha dhe të voglaregion- shteti ose provinca, me emrin nga /filters ose me kodin e Copart, për shembull "Texas" ose "TX"year_from, year_to- viti, nga dhe derikm_age_from, km_age_to- kilometrazhi në km, nga dhe deri. Lotet kanadeze nuk përputhen me këtë filtërprice_from, price_to- oferta aktuale, nga dhe deri, në monedhën e lotit. Lotet pa oferta nuk përputhen me këta filtra
Për të dërguar disa vlera në një filtër, përsëritni parametrin me kllapa katrore: 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=3000Përgjigjja:
{
"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": { // vlerat origjinale nga 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
}
}
// ... lotet e tjera të faqes, deri në 20
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Fushat e të dhënave:
Loti dhe çmimi
id - ID-ja e brendshme në bazën e të dhënave
inner_id - Numri i lotit në Copart, i njëjti si në lidhjen e lotit. Me këtë numër e kërkoni lotin te /offer.
url - Faqja e lotit në copart.com.
price, currency - Oferta aktuale dhe monedha e lotit, USD ose CAD. Kur nuk ka oferta, price është null. Ky nuk është çmimi i shitjes: Copart nuk e publikon.
buy_it_now_price - Çmimi Buy It Now, nëse shitësi e ka vendosur, përndryshe null.
estimated_retail_value - Vlera e vlerësuar me pakicë e makinës sipas Copart.
repair_cost - Kostoja e vlerësuar e riparimit sipas Copart, ndonjëherë me cent.
section - "Used" për çdo lot.
description - Lotet e Copart nuk kanë përshkrim nga shitësi, prandaj kjo fushë është gjithmonë null.
created_at - Kur loti u shfaq në bazën tonë të të dhënave.
Makina
mark, model - Marka nga një listë referuese ("Hyundai", "Mercedes-Benz"), modeli siç e shkruan Copart, me shkronja të mëdha ("SONATA").
complectation - Varianti siç e shkruan Copart, për shembull "SE".
year - Viti i modelit.
first_registration - Copart nuk e publikon datën e regjistrimit të parë, prandaj është gjithmonë null.
vin - Maska e VIN-it si në Copart: 11 karaktere dhe yje. Makinat e prodhuara para vitit 1981 kanë numër më të shkurtër.
km_age - Kilometrazhi në km për lotet në SHBA. Për lotet kanadeze është null.
odometer - Leximi i odometrit si në Copart, në milje për lotet në SHBA.
odometer_status - Statusi i leximit: "Actual", "Not actual", "Exempt" ose "Exceeds mechanical limits".
owners_count - Copart nuk e publikon numrin e pronarëve, prandaj është gjithmonë null.
Specifikimet
engine_type - Karburanti, për shembull "Gasoline", "Diesel", "Hybrid", "Electric" ose "Flex fuel".
transmission_type - "Automatic", "Manual" ose "None".
body_type - Lloji i karrocerisë, për shembull "Sedan" ose "SUV".
drive_type - Tërheqja: "Front-wheel drive", "Rear-wheel drive", "All-wheel drive", "4x4" ose "4x2" kur Copart nuk tregon cili bosht është tërheqës.
color - Ngjyra e karrocerisë.
displacement, displacement_cc - Vëllimi i motorit në litra dhe në cc. Për makinat elektrike është null.
cylinders - Numri i cilindrave.
power, power_ice_hp, power_electro_kw, seat_count - Copart nuk publikon as fuqinë, as numrin e vendeve, prandaj këto fusha janë gjithmonë null.
Gjendja dhe certifikata e pronësisë
primary_damage, secondary_damage - Dëmtimi kryesor dhe dytësor, për shembull "Front end" ose "Undercarriage".
condition - Gjendja sipas kontrollit të Copart: "Runs and drives", "Engine starts" ose "Enhanced vehicle".
has_keys - Çelësat e makinës janë të pranishëm (true) ose jo (false). Nëse Copart nuk e ka treguar, vlera është null.
title_type - Emri i certifikatës së pronësisë siç e shkruan Copart, me shkronja të mëdha, për shembull "SALVAGE VEHICLE TITLE". Çdo shtet ka emërtimet e veta.
title_group - Grupi i certifikatës së pronësisë: "Clean title", "Salvage title" ose "Non-repairable".
title_state - Shteti ose provinca ku është lëshuar certifikata e pronësisë.
Ankandi dhe vendndodhja
auction_at - Data dhe ora e ankandit në UTC. Derisa ankandi të caktohet, vlera është null.
auction_timezone - Zona kohore e sheshit të Copart, siç tregohet në faqen e internetit, për shembull "CST".
sale_type - Lloji i shitjes: "Pure sale", "Minimum bid", "On approval" ose "Not on sale".
lot_features - Etiketat e lotit si listë, për shembull "Hot item", "No license required" ose "Hybrid". Varg bosh për një lot pa etiketa.
seller - Shitësi, nëse Copart e tregon: zakonisht një kompani sigurimi ose një tregtar. Përndryshe null.
seller_type, is_dealer, salon_id - Copart nuk e publikon llojin e shitësit, prandaj këto fusha janë gjithmonë null.
country - "USA" ose "Canada".
region, city - Shteti ose provinca dhe qyteti i sheshit ku ndodhet makina.
zip - Kodi postar, në formën "77049-1968" për lotet në SHBA.
address - Sheshi i Copart ku ndodhet makina, siç tregohet në faqen e internetit: "TX - HOUSTON EAST".
latitude, longitude - Koordinatat e këtij sheshi të Copart.
Fotot, videot dhe të dhënat referuese
photos - Fotot e lotit sipas radhës.
photo_details - Të njëjtat foto me këndin (type), për shembull "Front left", "Odometer" ose "Engine", dhe lidhjen (url). Disa lote nuk kanë etiketa, dhe atëherë vlera është null.
panorama_360 - Panorama 360: exterior mban sipas radhës kuadrot e xhirimit rreth makinës, interior është një foto sferike e brendësisë ose null. Pa panoramë, i gjithë blloku është null.
engine_video_url - Video me tingullin e motorit në punë (mp4).
options - Copart nuk i publikon pajisjet, prandaj kjo fushë është gjithmonë null.
original - Vlerat e fushave kryesore nga copart.com para përkthimit.
catalog_ids - Kodi i markës në Copart, për shembull "HYUN". Kode modeli dhe varianti nuk ka, prandaj ato janë null.
GET/change_id
Merrni ID-në e parë të ndryshimit sipas datës (për përdorim në /changes)
Parametrat:
date(i detyrueshëm) - data në formatin yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/copart/change_id?api_key=YOUR_API_KEY&date=2026-11-10Përgjigjja:
{
"change_id": 312400
}Përdorni vlerën e kthyer si parametrin change_id në /changes
GET/changes
Fluksi i ndryshimeve (të shtuara/të ndryshuara/të hequra)
Parametrat:
change_id(i detyrueshëm) - nga cila ID ndryshimi të fillohet
https://{access_name}.auto-api.com/api/v3/copart/changes?api_key=YOUR_API_KEY&change_id=312412Përgjigjja:
{
"result": [
{
"id": 312412,
"inner_id": "61238556",
"change_type": "changed",
"created_at": "2026-11-10T04:21:15Z",
"data": { // oferta e re në monedhën e lotit (null nëse nuk ka mbetur asnjë ofertë)
"new_price": 6600
}
},
{
"id": 312413,
"inner_id": "74646926",
"change_type": "added",
"created_at": "2026-11-10T04:21:16Z",
"data": { ... } // trupi i plotë i lotit, si në /offers
},
{
"id": 312414,
"inner_id": "65737096",
"change_type": "removed",
"created_at": "2026-11-10T04:21:19Z",
"data": {} // loti u hoq nga shitja
}
// ... pastaj ngjarjet e tjera, deri në 20 për faqe
],
"meta": {
"cur_change_id": 312412,
"next_change_id": 312432,
"limit": 20
}
}GET/offer
Një lot i vetëm sipas inner_id.
Parametrat:
inner_id(i detyrueshëm)
https://{access_name}.auto-api.com/api/v3/copart/offer?api_key=YOUR_API_KEY&inner_id=45468636Përgjigjja përmban vetëm objektin data, pa mbështjellësin result.
Gabimet
Në rast gabimi, përgjigjja ka fushën error me një përshkrim: { "error": "parameter page is required" }
401- api_key nuk u pranua400- mungon një parametër i detyrueshëm ose një vlerë ka format të gabuar404- nuk ka lot me këtë inner_id (/offer)429- limiti i kërkesave është shteruar
Ruajtja
Skedarët mbeten të disponueshëm të paktën 3 ditë
Disponueshmëria
Skedarë të rinj çdo mëngjes
Formati CSV
Kolonat në CSV ndahen me vijën vertikale (|)
Struktura e URL-së:
Parametrat:
access_name- nëndomeni juaj personaldate- data e eksportimit në formatin yyyy-mm-dd, p.sh. 2026-11-10file_name- emri i skedarit me prapashtesë
Skedarët e disponueshëm:
- 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
Shembull kërkese me 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.csvShembull komande me Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Copart (copart.com) zhvillon ankande online makinash, përfshirë në SHBA dhe Kanada. Lotet janë të shpërndara nëpër sheshet e Copart, secili me adresën e vet dhe zonën kohore të ankandit. Makinat i nxjerrin në shitje kompanitë e sigurimit, tregtarët, bankat dhe kompanitë e makinave me qira.
Ofertimi bëhet online: para fillimit pranohen oferta paraprake, pastaj loti shitet në një ankand virtual të drejtpërdrejtë. Shitja mund të jetë pa çmim minimal, me ofertë minimale ose me miratimin e shitësit, dhe disa lote kanë një çmim Buy It Now. Copart nuk u tregon vizitorëve të faqes as VIN-in e plotë, as historikun e ofertave, as çmimin e shitjes.
Etiketa "No license required" shënon lotet për të cilat nuk ju duhet licencë tregtari për të bërë ofertë. Me shtetin dhe koordinatat e sheshit mund të përllogaritni transportin deri në port.
Lotet e reja, ofertat e reja dhe heqjet nga shitja vijnë përmes /changes. Një lot i hequr mund të jetë shitur, ose mund të jetë tërhequr.
Zgjeroni mbulimin e të dhënave tuaja automobilistike në tregjet botërore me API-të tona të platformave: