مرجع API / المركبات
البحث في مركبات المزادات النشطة
/carsحجم الصفحة 50 / 1000ابحث عن مركبات لها إعلانات نشطة في Copart أو IAAI. مناسب للتوريد، ومخزون المستوردين، والمراقبة، وتحليل السوق.
- صفِّ حسب المصدر والشركة المصنّعة والطراز والجيل والسنة والمسافة المقطوعة والسعر والموقع والضرر وتفاصيل المزاد. كل معاملات الاستعلام اختيارية.
- حجم الصفحة الافتراضي 50 في كل الباقات؛ والحد الأقصى 1000 في Unlimited. تُرتّب المركبات حسب المعرّف الداخلي تصاعديًا افتراضيًا. استخدم minutes للتحديثات خلال آخر 4320 دقيقة (72 ساعة) و
/archived-lotsلتتبع الإزالات. - تُعيد المركبات في data، مع الترقيم في links وmeta. تتضمن كل مركبة المواصفات ومصفوفة lots فيها معرّفات المصدر والصور والمسافة المقطوعة والأسعار وتواريخ المزادات والحالة عند توفرها. أضف
prices_history=1لتضمين مصفوفة prices لكل لوت. - الإعلان النشط لا يضمن أن المزايدة مفتوحة. راجع
exclude_expired_auctionsلمعرفة قيد حالي في التنفيذ.
- غيّر القيم أدناه
- يتحدّث الطلب على الجانبيتحدّث الطلب في الأعلى
- نفّذه مباشرة بمفتاحك
معاملات الاستعلام 46
معرّف منصة المصدر: 1 = IAAI و3 = Copart. احذفه للبحث في كل المصادر المتاحة لحسابك. يصفّي المركبات المطابقة؛ وقد تتضمن لوتاتها المتداخلة مصادر أخرى.
المركبات أو الإعلانات المحدّثة خلال آخر N دقيقة. استخدم 1–4320 (حتى 72 ساعة)، مثل 60. احذفه للتغذية العادية.
عدد السجلات في الصفحة. احذفه لـ 50. الحد الأقصى 1000 في Unlimited؛ وDemo وSmall محدودتان بـ 50.
رقم الصفحة، بدءًا من 1. احذفه لطلب الصفحة 1.
اضبطه على 1 لتخطي الأعداد الإجمالية، أو 0 لتضمينها. احذفه لاستخدام الإعداد الافتراضي لحسابك. الترقيم البسيط مناسب للمزامنات الكبيرة.
رتّب المركبات حسب المعرّف الداخلي للسيارة: asc (افتراضي) أو desc. لا يرتّب حسب وقت المزاد أو السعر.
اضبطه على 1 لتضمين مصفوفة سجل الأسعار لكل لوت. احذفه أو استخدم 0 للاستجابة العادية.
معرّف شركة مصنّعة واحد أو معرّفات مفصولة بفواصل من /manufacturers/{type}، مثل 16 (BMW) أو 16,20. أرسل سلسلة واحدة، لا مصفوفة.
المعرّف الداخلي للطراز من /models/{manufacturer_id}/{type}.
المعرّف الداخلي للجيل من /generations/{model_id}/{type}.
سنة الطراز بالضبط، مثل 2020. في /cars يُطبَّق مع أي نطاق سنوات.
أدنى سنة طراز، شاملة. يمكن دمجه مع to_year.
أعلى سنة طراز، شاملة. يمكن دمجه مع from_year.
رقم VIN (مطابقة للقيمة المخزّنة دون تمييز حالة الأحرف) أو رقم لوت من المصدر. لفلتر VIN فقط استخدم vin؛ وللبحث في النشطة والمؤرشفة استخدم /search-vin أو /search-lot.
فلتر VIN لا يميّز حالة الأحرف. استخدم _ كحرف بدل لعدة أحرف: YV1MC_ يطابق أرقام VIN التي تبدأ بـ YV1MC. دون حرف بدل يطابق القيمة المخزّنة كاملة.
جزء من عنوان المركبة دون تمييز حالة الأحرف، مثل Corvette.
معرّف فئة المركبة. راجع القيم المقبولة أدناه.
معرّف نوع الهيكل. راجع القيم المقبولة أدناه.
معرّف اللون الخارجي. راجع القيم المقبولة أدناه.
معرّف نوع الوقود. راجع القيم المقبولة أدناه.
معرّف ناقل الحركة: 1 = أوتوماتيك، 2 = يدوي.
معرّف نظام الدفع: 1 = خلفي، 2 = أمامي، 3 = رباعي.
معرّف حالة الإعلان. راجع القيم المقبولة أدناه.
عدد أسطوانات المحرك بالضبط، مثل 4 أو 6 أو 8.
جزء من اسم المحرك دون تمييز حالة الأحرف، مثل 2.0.
رمز من حرفين لبلد موقع المركبة، مثل US أو CA. احذفه لتضمين كل البلدان المتاحة.
رمز الولاية أو المقاطعة من /usa/states، مثل CA أو FL. لا يميّز حالة الأحرف؛ ادمجه مع country للتمييز بين المواقع ذات الرمز نفسه.
جزء من اسم الضرر الرئيسي أو الثانوي من /usa/damages دون تمييز حالة الأحرف، مثل hail أو front. أرسل سلسلة مفردة. إذا لم يطابق أي ضرر في القاموس، لا يُطبَّق الفلتر.
جزء من اسم وثيقة الملكية من /usa/titles دون تمييز حالة الأحرف، مثل salvage. يفحص عنوان الإعلان والعنوان المفصّل والمختصر. إذا لم تطابق أي وثيقة في القاموس، لا يُطبَّق الفلتر.
معرّف حالة المزاد. راجع القيم المقبولة أدناه. لعدة حالات استخدم status[] بدلًا منه؛ ولا ترسل الاثنين.
عدة معرّفات لحالة المزاد (1–10) كمفاتيح مكررة بأقواس، مثل status[]=4&status[]=5. يُستخدم بدلًا من status. لا ترسل status=[] ولا سلسلة JSON.
اضبطه على 1 لاشتراط سعر Buy Now موجب. القيمة 0 أو حذفه يترك Buy Now دون تصفية.
أدنى سعر Buy Now، شامل (1 أو أكثر، تُقبل الكسور العشرية). المبالغ بوحدات سعر المصدر المخزّنة دون تحويل أو رسوم.
أعلى سعر Buy Now، شامل (1 أو أكثر، تُقبل الكسور العشرية). المبالغ بوحدات سعر المصدر المخزّنة دون تحويل أو رسوم.
أدنى مزايدة مخزّنة، شاملة (1 أو أكثر، تُقبل الكسور العشرية). ليست مبلغ البيع النهائي.
أعلى مزايدة مخزّنة، شاملة (1 أو أكثر، تُقبل الكسور العشرية). ليست مبلغ البيع النهائي.
أدنى قراءة مسجّلة للعداد بالكيلومتر، شاملة. إذا حُدّد فلترا الكيلومتر والميل معًا، يجب أن يتطابق الاثنان.
أعلى قراءة مسجّلة للعداد بالكيلومتر، شاملة. إذا حُدّد فلترا الكيلومتر والميل معًا، يجب أن يتطابق الاثنان.
أدنى قراءة مسجّلة للعداد بالميل، شاملة. إذا حُدّد فلترا الكيلومتر والميل معًا، يجب أن يتطابق الاثنان.
أعلى قراءة مسجّلة للعداد بالميل، شاملة. إذا حُدّد فلترا الكيلومتر والميل معًا، يجب أن يتطابق الاثنان.
تاريخ المزاد بعد هذا التاريخ التقويمي تمامًا (YYYY-MM-DD). يُتجاهل جزء الوقت. يتقدّم على sale_date_in_days؛ ويُتجاهل مع without_sale_date=1.
تاريخ المزاد قبل هذا التاريخ التقويمي تمامًا (YYYY-MM-DD). يُتجاهل جزء الوقت. يُتجاهل مع without_sale_date=1.
اللوتات التي يقع تاريخ مزادها بعد N يومًا مضت، بما فيها التواريخ المستقبلية. يتقدّم عليه sale_date_from؛ ويُتجاهل مع without_sale_date=1.
أوقات المزادات بين الآن وN ساعة من الآن، شاملة، مثل 24. يُدمج مع فلاتر التاريخ الأخرى المفعّلة.
اضبطه على 1 لاختيار اللوتات دون تاريخ بيع. يتقدّم على sale_date_from وsale_date_to وsale_date_in_days.
قيد حالي في التنفيذ: رغم اسمه، القيمة 1 تختار اللوتات دون تاريخ بيع أو بتاريخ بيع أقدم من الآن، فلا تستبعد المزادات الماضية. احذفه أو استخدم 0؛ واستخدم next_hours_auction لنافذة المزادات القادمة.