انتقل إلى المحتوى

الأدلة

صيغة فلاتر البحث

توضع الفلاتر في سلسلة الاستعلام لـ /cars. كلها اختيارية وتُدمج بشرط AND.

احذف الفلاتر غير المستخدمة

لا ترسل أبدًا قيمة فارغة مثل domain_id= أو page=. اترك المعامل خارج الطلب.

المصدر والمركبة

القيمة domain_id=3 تعني Copart وdomain_id=1 تعني IAAI. يختار الفلتر المركبات التي لها إعلان مطابق؛ وقد تتضمن لوتاتها المتداخلة مصادر أخرى، لذا اقرأ lots[].domain.id.

عدة شركات مصنّعة

يقبل manufacturer_id سلسلة واحدة بمعرّفات مفصولة بفواصل، مثل 16,20. لا ترسل مصفوفة.

عدة حالات

استخدم مفاتيح مكررة بأقواس: status[]=4&status[]=5. لا تجمع بين status وstatus[]، ولا ترسل status=[] أبدًا.

البحث برقم VIN

يطابق vin رقم VIN المخزّن كاملًا دون تمييز حالة الأحرف. استخدم _ كحرف بدل: YV1MC_ يطابق كل VIN يبدأ بـ YV1MC. ويقبل search_query رقم VIN أو رقم لوت.

السنوات

القيمة year مطابقة تامة؛ وfrom_year وto_year حدود شاملة. في /cars تُطبَّق معًا.

تواريخ المزادات

المعاملان sale_date_from وsale_date_to تاريخان تقويميان غير شاملين (YYYY-MM-DD). يتقدّم sale_date_from على sale_date_in_days، ويتقدّم without_sale_date=1 على الثلاثة.

المتغيّرة مؤخرًا

تُعيد minutes=60 المركبات المحدّثة خلال الساعة الأخيرة. النطاق المدعوم 1–4320 دقيقة (72 ساعة).

الأسعار والعداد

تستخدم buy_now_price_* وbid_price_* وحدات سعر المصدر المخزّنة دون تحويل أو رسوم. إذا حُدّدت حدود بالكيلومتر والميل معًا، يجب أن يتطابق الاثنان.

الفلاتر النصية

الحقول name وengine_name وdamage وdocument_title مقاطع نصية لا تميّز حالة الأحرف. إذا لم يطابق damage أو document_title أي شيء في قاموسه، لا يُطبَّق الفلتر.

© 2025. AuctionsAPI operates independently and is not affiliated with Copart, IAAI or Encar.