
IAAI APIScraper وParser
IAAI API: لوتات مزادات سيارات التأمين في أمريكا وكندا بسعر Buy Now وتقديرات ACV وتكلفة الإصلاح والأضرار ونوع سند الملكية وتاريخ المزاد. تدفق التغييرات والملفات.
IAAI API
تجمع أداة استخراج البيانات لدينا لوتات المزادات من IAAI، مزادات سيارات التأمين في الولايات المتحدة وكندا، ومنها سيارات الركاب وسيارات SUV وشاحنات البيك أب وسيارات الفان. وعبر API يمكنك اختيار اللوتات بالفلاتر وفق متطلبات المشتري، ومتابعتها في تدفق التغييرات حتى سحبها من البيع. ولا حاجة إلى أن تكتب أداة خاصة بك لجمع بيانات iaai.com وأن تتولى صيانتها.
يعيد التدفق /changes أحداث لوتات IAAI: لوت جديد، وسعر Buy Now جديد، وسحب من البيع.
يضم التصدير اليومي لوتات IAAI المعروضة للبيع في تاريخ التصدير.
المسافة المقطوعة وحالة العداد، المحرك والقدرة، الأضرار، سبب البيع، نوع سند الملكية، مفاتيح السيارة والوسائد الهوائية، تاريخ المزاد والفرع، فئات المشترين المسموح لهم بالشراء، الصور وفيديو المحرك أثناء التشغيل.
للوت رقمان: inner_id الذي تطلب به اللوت من /offer، وstock_number، وهو الرقم الذي يعرفه به المشترون في مزادات IAAI.
الرابط الأساسي
https://{access_name}.auto-api.com/api/v3/iaaiالتفويض: 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 من الاستجابة. هكذا تصلك اللوتات الجديدة وأسعار Buy Now الجديدة وعمليات سحب اللوتات من البيع. وإذا وصل next_change_id بقيمة null فلا توجد أحداث بعد: أعد الطلب نفسه لاحقاً.
3. للبحث وفق شروطك، استدعِ /offers مع الفلاتر.
صيغة البيانات
- تبقى أنواع البيانات كما هي: الرقم يصل رقماً، والقائمة تصل مصفوفةً، أما القيمة الغائبة فيصل null مكانها.
- الطوابع الزمنية بتوقيت UTC، مثل "2026-11-12T14:30:00Z".
- السعر وACV وتقدير تكلفة الإصلاح بعملة اللوت: USD في لوتات الولايات المتحدة، وCAD في اللوتات الكندية.
- لكل اللوتات مجموعة الحقول نفسها. وإذا لم تتوفر القيمة يصل null، مثلاً في auction_at ما دام IAAI لم يحدد تاريخ المزاد. والاستثناء هو photos: ففي اللوت الذي لا صور له تكون قيمته مصفوفة فارغة.
GET/filters
إرجاع جميع القيم الممكنة للتصفية
https://{access_name}.auto-api.com/api/v3/iaai/filters?api_key=YOUR_API_KEYالاستجابة:
{
"mark": {
"CHEVROLET": { "model": [..., "TAHOE", "TAHOE HYBRID", "TAHOE K1500", "TRACKER", "TRAILBLAZER", ...] },
"FORD": { "model": [..., "EXPEDITION", "EXPEDITION EL", "EXPEDITION MAX", "EXPLORER", "EXPLORER SPORT", ...] },
"TOYOTA": { "model": [..., "RAV4 HYBRID", "RAV4 PLUG-IN HYBRID", "RAV4 PRIME", "RAV4 SE HYBRID", ...] },
...
},
"transmission_type": ["Automatic", "CVT", "Manual"],
"color": ["Beige", "Black", "Blue", "Brown", ...],
"body_type": [..., "Passenger van", "Pickup", "QUATTRO COUPE", "Roadster", ...],
"engine_type": ["Diesel", "Electric", "Flex fuel", "Gasoline", "Hybrid", "Other"],
"drive_type": ["4WD", "4x2", "AWD", ..., "FWD", ..., "RWD"]
}GET/offers
اللوتات صفحةً بعد صفحة. وتضيّق الفلاتر نطاق النتائج.
المعاملات:
page(مطلوب) - رقم الصفحةmark, model- الماركة والطراز كما في /filters، دون حساسية لحالة الأحرفtransmission_type, color, body_type, engine_type, drive_type- ناقل الحركة واللون والهيكل والوقود ونظام الدفع بالقيم الواردة في /filters، دون حساسية لحالة الأحرفyear_from, year_to- سنة الطراز، من وإلىkm_age_from, km_age_to- المسافة المقطوعة بالكيلومتر، من وإلىprice_from, price_to- سعر Buy Now، من وإلى، بعملة اللوت. واللوتات التي ليس لها Buy Now لا تطابق هذه الفلاتر
لتمرير عدة قيم إلى فلتر، كرر المعامل مع الأقواس المربعة: mark[]=CHEVROLET&mark[]=FORD
https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1&mark=CHEVROLET&model=TAHOE&year_from=2020https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1&body_type=Pickup&price_to=15000الاستجابة:
{
"result": [
{
"id": 61842,
"inner_id": "43963919~US",
"change_type": "added",
"created_at": "2026-10-25T05:41:52Z",
"data": {
"id": 61842,
"inner_id": "43963919~US",
"stock_number": "43468982",
"url": "https://www.iaai.com/VehicleDetail/43963919~US",
"mark": "CHEVROLET",
"model": "TAHOE",
"complectation": "2WD LT",
"year": 2021,
"first_registration": null,
"km_age": 187368,
"odometer": 116425,
"odometer_unit": "mi",
"odometer_status": "Not actual",
"owners_count": null,
"price": 14000,
"currency": "USD",
"acv": 38323,
"repair_cost": 25348,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "SUV",
"drive_type": "4x2",
"color": "Gray",
"interior_color": null,
"displacement": 5.3,
"displacement_cc": 5300,
"engine": "5.3L V-8 DI, VVT, 355HP",
"cylinders": 8,
"power": 355,
"power_ice_hp": 355,
"power_electro_kw": null,
"seat_count": null,
"section": "Used",
"seller_type": null,
"is_dealer": null,
"salon_id": null,
"seller_category": "Insurance company",
"region": "Georgia",
"city": "Winder",
"address": "1045 Atlanta Hwy SE",
"zip": "30680",
"latitude": 33.97598,
"longitude": -83.6573,
"description": null,
"created_at": "2026-10-25T05:41:52Z",
"offer_created": "2026-10-25T05:33:28Z",
"photos": [
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I1~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I2~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I3~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I4~RW2576~H1932~TH0&width=2576&height=1932",
...
],
"photo_360_url": "https://vis.iaai.com/Home/ThreeSixtyView?keys=SID-43963919~STP-1~INT-1&iframeview=true",
"engine_video_url": "https://mediastorageaccountprod.blob.core.windows.net/media/43963919_VES-100_1",
"vin": "1GNSCNKD0MR******",
"auction_at": "2026-11-12T14:30:00Z",
"auction_type": "Live auction",
"timed_auction_close_at": null,
"branch": "Atlanta East",
"branch_id": "707",
"lane": "D",
"run_number": 153,
"country": "USA",
"primary_damage": "Right rear",
"secondary_damage": "Rear",
"loss_type": "Collision",
"title_group": "Salvage",
"title_state": "Georgia",
"title_brand": null,
"title_notes": null,
"condition": "Run & drive",
"has_keys": true,
"airbags": "Intact",
"catalytic_converter": true,
"is_public": true,
"who_can_buy": ["Dealers", "Dismantlers", "Exporters", "Other licensed businesses", "Non-auto licensed businesses", "Public", "Rebuilders", "Scrappers"],
"vehicle_type": "SUV",
"country_of_origin": "USA",
"restraint_system": ["Driver front airbag", "Driver side airbag", "Curtain airbags", "Passenger front airbag", "Passenger side airbag", "Front center airbag"],
"declarations": null,
"original": { // القيم الأصلية من iaai.com
"mark": "CHEVROLET",
"model": "TAHOE",
"complectation": "2WD LT",
"engine_type": "GASOLINE",
"transmission_type": "AUTOMATIC",
"body_type": "UTILITY",
"drive_type": "4X2 DRIVE",
"color": "GRAY",
"interior_color": null,
"primary_damage": "Right Rear",
"secondary_damage": "Rear",
"loss_type": "Collision",
"title_group": "Salvage",
"condition": "Run & Drive",
"region": "GA"
},
"catalog_ids": {
"mark": null,
"model": null,
"complectation": null
},
"options": {
"Equipment": ["Console display"]
}
}
}
// ... ثم بقية اللوتات، حتى 20 في الصفحة
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}حقول البيانات:
اللوت
id - معرف قاعدة البيانات الداخلي
inner_id - معرف اللوت من رابط IAAI مع السوق بعد علامة التلدة: "43963919~US"، أو بالشكل "Imp_3139055~CA" في اللوتات الكندية. وهذا هو المعرف الذي تقبله /offer.
stock_number - الرقم Stock#: رقم اللوت الذي يعرضه IAAI على موقعه وفي المزاد.
url - رابط اللوت.
price, currency - سعر Buy Now والعملة، USD أو CAD. وإذا لم يكن للوت سعر Buy Now فقيمة price هي null.
acv - القيمة ACV، أي القيمة التقديرية للسيارة قبل الضرر.
repair_cost - التكلفة التقديرية للإصلاح.
section - القيمة "Used" دائماً.
description - وصف البائع. ولا يوجد وصف في لوتات IAAI، لذلك تكون قيمته null دائماً.
created_at - وقت وصول اللوت إلى قاعدة بياناتنا.
offer_created - وقت عرض اللوت كما يذكره IAAI. ويحدّثه IAAI، مثلاً عند إعادة عرض اللوت أو تغيير موعد المزاد، لذلك قد يكون لاحقاً لوقت created_at.
السيارة
mark, model - الماركة والطراز كما يكتبهما IAAI: "CHEVROLET"، "TAHOE".
complectation - الفئة، مثل "2WD LT".
year - سنة الطراز.
first_registration - التسجيل الأول. ولا ينشره IAAI، لذلك تكون قيمته null دائماً.
vin - رقم VIN كما يعرضه IAAI: أول 11 خانة، وبقية الخانات مخفية بعلامات النجمة.
km_age - المسافة المقطوعة بالكيلومتر. وإذا ذكر IAAI القيمة 0 أو 1 بدلاً من المسافة (العداد لا يُقرأ أو لا يعمل أو المسافة معفاة من الإفصاح)، تصل null.
odometer, odometer_unit - قراءة عداد المسافات كما على IAAI، ووحدتها: "mi" (ميل) أو "km".
odometer_status - حالة قراءة العداد، مثل "Actual"، "Not actual"، "Exceeds mechanical limits" أو "Exempt" (السيارات القديمة معفاة من الإفصاح عن المسافة المقطوعة).
owners_count - عدد الملاك. ولا ينشره IAAI، لذلك تكون قيمته null دائماً.
vehicle_type - نوع المركبة وفق تصنيف IAAI، مثل "Automobile" أو "Light truck" أو "Classic car". أما نوع الهيكل فيصل في body_type.
country_of_origin - بلد التجميع.
المواصفات
engine_type - الوقود: "Gasoline"، "Diesel"، "Hybrid"، "Electric"، "Flex fuel" أو "Other".
transmission_type - القيمة "Automatic" أو "Manual" أو "CVT".
body_type - نوع الهيكل، مثل "SUV" أو "Pickup". أما اسم الهيكل كما يكتبه IAAI ففي original.body_type.
drive_type - نظام الدفع: "FWD"، "RWD"، "AWD" أو "4WD". وتعني القيمة "4x2" أن IAAI لم يحدد أي المحورين هو محور الدفع.
color, interior_color - لون الهيكل ولون المقصورة.
displacement, displacement_cc - سعة المحرك باللتر كما يذكرها IAAI، والسعة نفسها بالسنتيمتر المكعب (5.3 لتر تساوي 5300).
engine - المحرك كما يصفه IAAI، مثل "5.3L V-8 DI, VVT, 355HP".
cylinders - عدد الأسطوانات.
power - القدرة بالحصان. وفي السيارات الهجينة والكهربائية تكون القيمة null: فلا ينشر IAAI القدرة الإجمالية للنظام.
power_ice_hp - قدرة محرك الاحتراق الداخلي بالحصان. ويُملأ هذا الحقل في السيارات الهجينة حتى عندما تكون قيمة power هي null.
power_electro_kw, seat_count - قدرة المحرك الكهربائي وعدد المقاعد. ولا ينشرهما IAAI، لذلك تكون قيمتهما null دائماً.
الأضرار وسند الملكية
primary_damage, secondary_damage - الضرر الرئيسي والضرر الثانوي، مثل "Front end"، "Left side"، "Flood" أو "Hail".
loss_type - سبب طرح السيارة في المزاد: "Collision"، "Theft"، "Flood"، "Fire" أو "Other".
condition - حالة التشغيل: "Run & drive"، "Starts"، "Stationary" أو "Can't test".
has_keys - هل مفاتيح السيارة موجودة (true/false).
airbags - حالة الوسائد الهوائية، مثل "Intact"، "Deployed" أو "Missing".
restraint_system - الوسائد الهوائية وأحزمة الأمان الموجودة في السيارة.
catalytic_converter - المحول الحفاز في مكانه (true) أو منزوع (false).
title_group - نوع سند الملكية: "Clear"، "Salvage"، "Non-repairable" وغيرها. وفي اللوتات الكندية يصل كما يكتبه IAAI، مثل "ON-NOT BRANDED-ONTARIO". وتكون القيمة null ما دام سند الملكية لم يصل إلى IAAI.
title_state - الولاية أو المقاطعة التي أصدرت سند الملكية.
title_brand, title_notes - العلامة المدونة في سند الملكية والملاحظات عليه كما يكتبها IAAI، مثل "PREVIOUS SALVAGE".
declarations - إقرارات البائع في اللوتات الكندية، بالنص كما يكتبه IAAI، مثل "TKU" (المسافة الفعلية غير معروفة) أو إشارة إلى تقرير CARFAX.
المزاد والبائع والموقع الجغرافي
auction_at - بداية المزاد المباشر. والقيمة null ما دام IAAI لم يحدد الموعد. ولا يُنشئ تحديد موعد المزاد أو تغييره حدثاً في /changes. وتعيد /offer و/offers تاريخ المزاد ووقته وفق آخر تحديث.
auction_type - القيمة "Live auction" أو "Timed auction".
timed_auction_close_at - نهاية المزاد محدد المدة.
branch, branch_id - فرع IAAI الذي يُباع فيه اللوت، ورقم الفرع.
lane, run_number - مسار المزاد ورقم دور اللوت فيه. ويحددهما IAAI قبل المزاد بوقت قصير، وحتى ذلك الحين تكون القيمة null. ومثل تاريخ المزاد، لا يصلان أحداثاً منفصلة في /changes.
is_public - القيمة true إذا كان اللوت متاحاً للمشترين الأفراد (علامة Public). ومن يحق له أيضاً شراء اللوت مذكور في who_can_buy.
who_can_buy - من يحق له شراء اللوت: "Dealers"، "Dismantlers"، "Exporters"، "Public" وغيرها. ويملأ IAAI القائمة مع اقتراب موعد المزاد، وحتى ذلك الحين تكون القيمة null.
seller_category - من أين جاءت السيارة إلى المزاد: "Insurance company"، "Remarketing"، "Lease and rental"، "Repossession" وغيرها.
seller_type, is_dealer, salon_id - البائع. ولا يعرضه IAAI، لذلك تكون قيمة هذه الحقول null دائماً.
country - القيمة "USA" أو "Canada".
region, city - الولاية أو المقاطعة والمدينة التي توجد فيها السيارة.
address, zip - العنوان والرمز البريدي للمكان نفسه.
latitude, longitude - إحداثيات المكان نفسه. وفي اللوتات الكندية تكون القيمة null.
الصور ومقاطع الفيديو والبيانات المرجعية
photos - روابط الصور بحجمها الكامل. وفي اللوت الذي لا صور له تصل مصفوفة فارغة.
photo_360_url - رابط عرض 360 درجة على موقع IAAI.
engine_video_url - رابط فيديو المحرك أثناء التشغيل.
options - التجهيزات كما يسردها IAAI، في مجموعة واحدة "Equipment".
original - القيم الأصلية للحقول الرئيسية من iaai.com، دون ترجمة.
catalog_ids - رموز الكتالوج. ولا ينشرها IAAI، لذلك تكون القيم null دائماً.
GET/change_id
الحصول على أول معرف تغيير حسب التاريخ (للاستخدام في /changes)
المعاملات:
date(مطلوب) - التاريخ بتنسيق yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10الاستجابة:
{
"change_id": 208400
}استخدم القيمة المرجعة كمعامل change_id في /changes
GET/changes
تغذية التغييرات (مضاف/معدل/محذوف)
المعاملات:
change_id(مطلوب) - بدءاً من أي معرف تغيير
https://{access_name}.auto-api.com/api/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412الاستجابة:
{
"result": [
{
"id": 208412,
"inner_id": "46237543~US",
"change_type": "changed",
"created_at": "2026-11-10T03:12:40Z",
"data": { // سعر Buy Now الجديد بعملة اللوت (null إذا أُزيل Buy Now)
"new_price": 28225
}
},
{
"id": 208413,
"inner_id": "47020463~US",
"change_type": "added",
"created_at": "2026-11-10T03:12:41Z",
"data": { ... } // محتوى اللوت كاملاً، كما في /offers
},
{
"id": 208414,
"inner_id": "46769371~US",
"change_type": "removed",
"created_at": "2026-11-10T03:12:43Z",
"data": {} // سُحب اللوت من البيع
}
// ... ثم بقية الأحداث، حتى 20 في الصفحة
],
"meta": {
"cur_change_id": 208412,
"next_change_id": 208432,
"limit": 20
}
}GET/offer
لوت واحد حسب inner_id.
المعاملات:
inner_id(مطلوب)
https://{access_name}.auto-api.com/api/v3/iaai/offer?api_key=YOUR_API_KEY&inner_id=43963919~USلا تضم الاستجابة إلا الكائن 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'موقع IAAI (iaai.com) تابع لمزادات Insurance Auto Auctions (IAA). ومنذ عام 2023 أصبحت الشركة جزءاً من RB Global. وتصل السيارات إلى المزادات في الولايات المتحدة وكندا من شركات التأمين بعد حادث تصادم أو غرق أو حريق أو سرقة، وكذلك من البنوك والوكلاء وشركات التأجير التمويلي وتأجير السيارات.
يُباع اللوت في مزاد مباشر في يوم محدد أو في مزاد محدد المدة، ويمكن شراء بعض اللوتات قبل المزاد بسعر Buy Now. وتُباع بعض اللوتات للمشترين المرخصين فقط، مثل الوكلاء وورش تفكيك السيارات والمصدّرين، أما اللوتات التي تحمل علامة Public فمتاحة أيضاً للمشترين الأفراد. ولا ينشر IAAI المزايدات ولا أسعار البيع للعموم.
يرى المستورد في اللوت هل يُسمح للمصدّرين بشرائه. ومن سنة الطراز وسعة المحرك وقدرته يمكن تقدير الرسوم الجمركية، ومن أول 11 خانة من VIN يمكن التحقق من الطراز ومصنع التجميع.
تصل عبر /changes اللوتات الجديدة، وأسعار Buy Now الجديدة، وعمليات السحب من البيع. ولا يعني سحب اللوت من البيع دائماً أنه قد بيع.
وسّع تغطية بيانات سياراتك عبر الأسواق العالمية باستخدام واجهاتنا البرمجية للمنصات: