
Copart APIScraper وParser
Copart API: لوتات مزاد إلكتروني بالمزايدة الحالية وسعر Buy It Now وتقديرات قيمة التجزئة وتكلفة الإصلاح والأضرار ونوع سند الملكية. تدفق تغيّر المزايدات والملفات.
Copart API
تجمع أداتنا لاستخراج البيانات لوتات سيارات الركاب من Copart، مزاد السيارات عبر الإنترنت في الولايات المتحدة وكندا. وعبر API يمكنك متابعة المزايدات على الطرازات التي تحتاجها، واختيار اللوتات حسب الولاية التي توجد فيها السيارة. ولا حاجة إلى تشغيل أداة خاصة بك لجمع بيانات copart.com.
تصل عبر /changes لوتات Copart الجديدة، والمزايدات الجديدة، واللوتات المسحوبة من البيع.
يضم التصدير اليومي لوتات Copart المعروضة للبيع في تاريخ التصدير.
المزايدة وسعر Buy It Now، تقديرات القيمة وتكلفة الإصلاح، نوع البيع وتاريخ المزاد، الأضرار وسند الملكية، مفاتيح السيارة، الصور مع زوايا التصوير، بانوراما 360 درجة وفيديو المحرك.
سعر اللوت هو المزايدة الحالية. أما سعر Buy It Now والقيمة التقديرية بسعر التجزئة والتكلفة التقديرية للإصلاح فتصل في حقول منفصلة.
الرابط الأساسي
https://{access_name}.auto-api.com/api/v3/copartالتفويض: api_key معامل
سير العمل
/filtersالحصول على قيم الفلتر المتاحةالتحميل الأولي:
/change_id?date=...الحصول على معرف البداية لتغذية التغييرات/offersتحميل كل اللوتات صفحةً بعد صفحة/changes?change_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 - معرف قاعدة البيانات الداخلي
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
الحصول على أول معرف تغيير حسب التاريخ (للاستخدام في /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(مطلوب) - بدءاً من أي معرف تغيير
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 مفصولة بالرمز العمودي (|)
بنية الرابط:
المعاملات:
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 اللوتات الجديدة والمزايدات الجديدة وعمليات السحب من البيع. وقد يكون اللوت المسحوب من البيع قد بيع، أو أُلغي عرضه.
وسّع تغطية بيانات سياراتك عبر الأسواق العالمية باستخدام واجهاتنا البرمجية للمنصات: