AUTO-API.COM
شعار ⁦IAAI⁩‏

IAAI API‏⁦Scraper⁩ و⁦Parser⁩‏

‏⁦IAAI API⁩: لوتات مزادات سيارات التأمين في أمريكا وكندا بسعر ⁦Buy Now⁩ وتقديرات ⁦ACV⁩ وتكلفة الإصلاح والأضرار ونوع سند الملكية وتاريخ المزاد. تدفق التغييرات والملفات.‏

مكتبات SDK الرسمية

تتوفر طرق ⁦API⁩ في حزم ⁦SDK⁩ لدينا على شكل دوال جاهزة، والمكتبات مفتوحة المصدر على ⁦GitHub⁩.‏

‏⁦IAAI API⁩‏

تجمع أداة استخراج البيانات لدينا لوتات المزادات من ⁦IAAI⁩، مزادات سيارات التأمين في الولايات المتحدة وكندا، ومنها سيارات الركاب وسيارات ⁦SUV⁩ وشاحنات البيك أب وسيارات الفان. وعبر ⁦API⁩ يمكنك اختيار اللوتات بالفلاتر وفق متطلبات المشتري، ومتابعتها في تدفق التغييرات حتى سحبها من البيع. ولا حاجة إلى أن تكتب أداة خاصة بك لجمع بيانات ⁦iaai.com⁩ وأن تتولى صيانتها.‏

‏⁦API⁩‏

يعيد التدفق ⁦/changes⁩ أحداث لوتات ⁦IAAI⁩: لوت جديد، وسعر ⁦Buy Now⁩ جديد، وسحب من البيع.‏

التصديرات اليومية

يضم التصدير اليومي لوتات ⁦IAAI⁩ المعروضة للبيع في تاريخ التصدير.‏

بيانات كاملة

المسافة المقطوعة وحالة العداد، المحرك والقدرة، الأضرار، سبب البيع، نوع سند الملكية، مفاتيح السيارة والوسائد الهوائية، تاريخ المزاد والفرع، فئات المشترين المسموح لهم بالشراء، الصور وفيديو المحرك أثناء التشغيل.‏

احصل على وصول ⁦API⁩‏يتم توفير الوصول خلال دقيقتين

للوت رقمان: ⁦inner_id⁩ الذي تطلب به اللوت من ⁦/offer⁩، و⁦stock_number⁩، وهو الرقم الذي يعرفه به المشترون في مزادات ⁦IAAI⁩.‏

الرابط الأساسي

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

التفويض: api_key معامل

سير العمل

1
/filtersالحصول على قيم الفلتر المتاحة
2

التحميل الأولي:‏

/change_id?date=...الحصول على معرف البداية لتغذية التغييرات
/offersجلب كل اللوتات صفحةً بعد صفحة
3
/changes?change_id=...الحصول على جميع التغييرات في قاعدة البيانات بدءاً من المعرف
4
/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⁩ مفصولة بالرمز العمودي (|)‏

بنية الرابط:‏

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'
‏⁦IAAI⁩‏

موقع ⁦IAAI⁩ ⁦(iaai.com)⁩ تابع لمزادات ⁦Insurance Auto Auctions⁩ ⁦(IAA)⁩. ومنذ عام 2023 أصبحت الشركة جزءاً من ⁦RB Global⁩. وتصل السيارات إلى المزادات في الولايات المتحدة وكندا من شركات التأمين بعد حادث تصادم أو غرق أو حريق أو سرقة، وكذلك من البنوك والوكلاء وشركات التأجير التمويلي وتأجير السيارات.‏

يُباع اللوت في مزاد مباشر في يوم محدد أو في مزاد محدد المدة، ويمكن شراء بعض اللوتات قبل المزاد بسعر ⁦Buy Now⁩. وتُباع بعض اللوتات للمشترين المرخصين فقط، مثل الوكلاء وورش تفكيك السيارات والمصدّرين، أما اللوتات التي تحمل علامة ⁦Public⁩ فمتاحة أيضاً للمشترين الأفراد. ولا ينشر ⁦IAAI⁩ المزايدات ولا أسعار البيع للعموم.‏

يرى المستورد في اللوت هل يُسمح للمصدّرين بشرائه. ومن سنة الطراز وسعة المحرك وقدرته يمكن تقدير الرسوم الجمركية، ومن أول 11 خانة من ⁦VIN⁩ يمكن التحقق من الطراز ومصنع التجميع.‏

تصل عبر ⁦/changes⁩ اللوتات الجديدة، وأسعار ⁦Buy Now⁩ الجديدة، وعمليات السحب من البيع. ولا يعني سحب اللوت من البيع دائماً أنه قد بيع.‏

الرد خلال دقيقتين