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

مرجع API / المركبات

البحث في مركبات المزادات النشطة

GET/carsحجم الصفحة 50 / 1000

ابحث عن مركبات لها إعلانات نشطة في Copart أو IAAI. مناسب للتوريد، ومخزون المستوردين، والمراقبة، وتحليل السوق.

  • صفِّ حسب المصدر والشركة المصنّعة والطراز والجيل والسنة والمسافة المقطوعة والسعر والموقع والضرر وتفاصيل المزاد. كل معاملات الاستعلام اختيارية.
  • حجم الصفحة الافتراضي 50 في كل الباقات؛ والحد الأقصى 1000 في Unlimited. تُرتّب المركبات حسب المعرّف الداخلي تصاعديًا افتراضيًا. استخدم minutes للتحديثات خلال آخر 4320 دقيقة (72 ساعة) و/archived-lots لتتبع الإزالات.
  • تُعيد المركبات في data، مع الترقيم في links وmeta. تتضمن كل مركبة المواصفات ومصفوفة lots فيها معرّفات المصدر والصور والمسافة المقطوعة والأسعار وتواريخ المزادات والحالة عند توفرها. أضف prices_history=1 لتضمين مصفوفة prices لكل لوت.
  • الإعلان النشط لا يضمن أن المزايدة مفتوحة. راجع exclude_expired_auctions لمعرفة قيد حالي في التنفيذ.
  1. غيّر القيم أدناه
  2. يتحدّث الطلب على الجانبيتحدّث الطلب في الأعلى
  3. نفّذه مباشرة بمفتاحك

معاملات الاستعلام 46

integer

معرّف منصة المصدر: 1 = IAAI و3 = Copart. احذفه للبحث في كل المصادر المتاحة لحسابك. يصفّي المركبات المطابقة؛ وقد تتضمن لوتاتها المتداخلة مصادر أخرى.

integer · 1–4320

المركبات أو الإعلانات المحدّثة خلال آخر N دقيقة. استخدم 1–4320 (حتى 72 ساعة)، مثل 60. احذفه للتغذية العادية.

integer · 1–1000

عدد السجلات في الصفحة. احذفه لـ 50. الحد الأقصى 1000 في Unlimited؛ وDemo وSmall محدودتان بـ 50.

integer · 1+

رقم الصفحة، بدءًا من 1. احذفه لطلب الصفحة 1.

integer · 0–1

اضبطه على 1 لتخطي الأعداد الإجمالية، أو 0 لتضمينها. احذفه لاستخدام الإعداد الافتراضي لحسابك. الترقيم البسيط مناسب للمزامنات الكبيرة.

string

رتّب المركبات حسب المعرّف الداخلي للسيارة: asc (افتراضي) أو desc. لا يرتّب حسب وقت المزاد أو السعر.

integer · 0–1

اضبطه على 1 لتضمين مصفوفة سجل الأسعار لكل لوت. احذفه أو استخدم 0 للاستجابة العادية.

string

معرّف شركة مصنّعة واحد أو معرّفات مفصولة بفواصل من /manufacturers/{type}، مثل 16 (BMW) أو 16,20. أرسل سلسلة واحدة، لا مصفوفة.

integer · 1+

المعرّف الداخلي للطراز من /models/{manufacturer_id}/{type}.

integer · 1+

المعرّف الداخلي للجيل من /generations/{model_id}/{type}.

integer

سنة الطراز بالضبط، مثل 2020. في /cars يُطبَّق مع أي نطاق سنوات.

integer

أدنى سنة طراز، شاملة. يمكن دمجه مع to_year.

integer

أعلى سنة طراز، شاملة. يمكن دمجه مع from_year.

string

رقم VIN (مطابقة للقيمة المخزّنة دون تمييز حالة الأحرف) أو رقم لوت من المصدر. لفلتر VIN فقط استخدم vin؛ وللبحث في النشطة والمؤرشفة استخدم /search-vin أو /search-lot.

string

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

string

جزء من عنوان المركبة دون تمييز حالة الأحرف، مثل Corvette.

integer

معرّف فئة المركبة. راجع القيم المقبولة أدناه.

integer

معرّف نوع الهيكل. راجع القيم المقبولة أدناه.

integer

معرّف اللون الخارجي. راجع القيم المقبولة أدناه.

integer

معرّف نوع الوقود. راجع القيم المقبولة أدناه.

integer

معرّف ناقل الحركة: 1 = أوتوماتيك، 2 = يدوي.

integer

معرّف نظام الدفع: 1 = خلفي، 2 = أمامي، 3 = رباعي.

integer

معرّف حالة الإعلان. راجع القيم المقبولة أدناه.

integer

عدد أسطوانات المحرك بالضبط، مثل 4 أو 6 أو 8.

string

جزء من اسم المحرك دون تمييز حالة الأحرف، مثل 2.0.

string

رمز من حرفين لبلد موقع المركبة، مثل US أو CA. احذفه لتضمين كل البلدان المتاحة.

string

رمز الولاية أو المقاطعة من /usa/states، مثل CA أو FL. لا يميّز حالة الأحرف؛ ادمجه مع country للتمييز بين المواقع ذات الرمز نفسه.

string

جزء من اسم الضرر الرئيسي أو الثانوي من /usa/damages دون تمييز حالة الأحرف، مثل hail أو front. أرسل سلسلة مفردة. إذا لم يطابق أي ضرر في القاموس، لا يُطبَّق الفلتر.

string

جزء من اسم وثيقة الملكية من /usa/titles دون تمييز حالة الأحرف، مثل salvage. يفحص عنوان الإعلان والعنوان المفصّل والمختصر. إذا لم تطابق أي وثيقة في القاموس، لا يُطبَّق الفلتر.

integer

معرّف حالة المزاد. راجع القيم المقبولة أدناه. لعدة حالات استخدم status[] بدلًا منه؛ ولا ترسل الاثنين.

array of integers

عدة معرّفات لحالة المزاد (1–10) كمفاتيح مكررة بأقواس، مثل status[]=4&status[]=5. يُستخدم بدلًا من status. لا ترسل status=[] ولا سلسلة JSON.

integer · 0–1

اضبطه على 1 لاشتراط سعر Buy Now موجب. القيمة 0 أو حذفه يترك Buy Now دون تصفية.

number · 1+

أدنى سعر Buy Now، شامل (1 أو أكثر، تُقبل الكسور العشرية). المبالغ بوحدات سعر المصدر المخزّنة دون تحويل أو رسوم.

number · 1+

أعلى سعر Buy Now، شامل (1 أو أكثر، تُقبل الكسور العشرية). المبالغ بوحدات سعر المصدر المخزّنة دون تحويل أو رسوم.

number · 1+

أدنى مزايدة مخزّنة، شاملة (1 أو أكثر، تُقبل الكسور العشرية). ليست مبلغ البيع النهائي.

number · 1+

أعلى مزايدة مخزّنة، شاملة (1 أو أكثر، تُقبل الكسور العشرية). ليست مبلغ البيع النهائي.

integer · 1+

أدنى قراءة مسجّلة للعداد بالكيلومتر، شاملة. إذا حُدّد فلترا الكيلومتر والميل معًا، يجب أن يتطابق الاثنان.

integer · 1+

أعلى قراءة مسجّلة للعداد بالكيلومتر، شاملة. إذا حُدّد فلترا الكيلومتر والميل معًا، يجب أن يتطابق الاثنان.

integer · 1+

أدنى قراءة مسجّلة للعداد بالميل، شاملة. إذا حُدّد فلترا الكيلومتر والميل معًا، يجب أن يتطابق الاثنان.

integer · 1+

أعلى قراءة مسجّلة للعداد بالميل، شاملة. إذا حُدّد فلترا الكيلومتر والميل معًا، يجب أن يتطابق الاثنان.

string (date)

تاريخ المزاد بعد هذا التاريخ التقويمي تمامًا (YYYY-MM-DD). يُتجاهل جزء الوقت. يتقدّم على sale_date_in_days؛ ويُتجاهل مع without_sale_date=1.

string (date)

تاريخ المزاد قبل هذا التاريخ التقويمي تمامًا (YYYY-MM-DD). يُتجاهل جزء الوقت. يُتجاهل مع without_sale_date=1.

integer · 1+

اللوتات التي يقع تاريخ مزادها بعد N يومًا مضت، بما فيها التواريخ المستقبلية. يتقدّم عليه sale_date_from؛ ويُتجاهل مع without_sale_date=1.

integer · 1+

أوقات المزادات بين الآن وN ساعة من الآن، شاملة، مثل 24. يُدمج مع فلاتر التاريخ الأخرى المفعّلة.

integer · 0–1

اضبطه على 1 لاختيار اللوتات دون تاريخ بيع. يتقدّم على sale_date_from وsale_date_to وsale_date_in_days.

integer · 0–1

قيد حالي في التنفيذ: رغم اسمه، القيمة 1 تختار اللوتات دون تاريخ بيع أو بتاريخ بيع أقدم من الآن، فلا تستبعد المزادات الماضية. احذفه أو استخدم 0؛ واستخدم next_hours_auction لنافذة المزادات القادمة.

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