Dongchedi New Cars APIScraper وParser

GET/filters

الماركات وطرازاتها والقيم المسموح بها لباقي فلاتر ⁦/offers⁩. وتُحدَّث مرة يومياً.

الاستجابة:

{
  "mark": {
    "Voyah": {
      "model": ["Voyah Dreamer EV", "Voyah Dreamer PHEV", "Voyah FREE", "Voyah Taishan", "Voyah Zhiyin", // ...]
    },
    "Tank": {
      "model": ["Tank 300", "Tank 400", "Tank 400 Hi4-T", "Tank 400 Hi4-Z", "Tank 500", // ...]
    },
    "Xiaomi": {
      "model": ["Xiaomi SU7", "Xiaomi SU7 Ultra", "Xiaomi YU7"]
    },
    "...": { ... }
  },
  "engine_type": ["EREV", "PHEV", "diesel", "electric", "hybrid", "petrol", // ...],
  "transmission_type": ["AMT", "CVT", "DHT", "E-CVT", "automatic", "dry DCT", "manual", "single-speed", "unknown", "wet DCT", // ...],
  "drive_type": ["AWD", "FWD", "RWD"],
  "body_type": ["SUV", "hatchback", "liftback", "minivan", "pickup", "sedan", "wagon", // ...]
}

GET/offers

قائمة الفئات المعروضة للبيع: صفحات من 20 سجلاً، والفلاتر اختيارية.

المعاملات:

• page (مطلوب) - رقم الصفحة
• mark, model - الماركة والطراز بالصيغة نفسها المسجلة في ⁦/filters⁩
• engine_type, transmission_type, drive_type, body_type - الوقود وناقل الحركة ونظام الدفع والهيكل؛ وحالة الأحرف غير مهمة
• year_from, year_to - حدود سنة الطراز
• price_from, price_to - السعر باليوان، ويُقارن بالحقل price

الاستجابة:

{
  "result": [
    {
      "id": 10383,
      "inner_id": "101727",
      "change_type": "added",
      "created_at": "2026-04-20T17:40:41.692+03:00",
      "data": {
        "id": "10383",
        "inner_id": "101727",
        "url": "https://www.dongchedi.com/auto/series/4760/model-101727",
        "mark": "Voyah",
        "model": "Voyah FREE",
        "complectation": "318 4WD Explorer Edition",
        "year": "2025",
        "price": "246900",
        "official_price": "266900",
        "cut_price": "20000",
        "engine_type": "EREV",
        "transmission_type": "single-speed",
        "drive_type": "AWD",
        "body_type": "SUV",
        "displacement": "1.5",
        "doors_count": "5",
        "horse_power": "490",
        "ice_power_ps": "150",
        "ice_power_kw": "110",
        "electric_power_ps": "490",
        "electric_power_kw": "360",
        "hybrid_power_ps": "",
        "hybrid_power_kw": "",
        "equipment": {
          "Basic information": { "Manufacturer": "VOYAH", "Class": "full-size suv", "Launch date": "2024.06", "CLTC electric range (km)": "259", "0-100 km/h acceleration, official (s)": "4.5", "Vehicle warranty": "5 years or 100,000 km", // ... },
          "Body": { "Length (mm)": "4905", "Width (mm)": "1950", "Height (mm)": "1645", "Wheelbase (mm)": "2960", "Curb weight (kg)": "2260", "Trunk volume (L)": "560-1320", // ... },
          "Engine": { "Engine model": "DAM15NTDE", "Displacement (mL)": "1499", "Aspiration": "Turbocharged", "Max power (hp)": "150", "Emission standard": "China VI b", // ... },
          "Electric motor": { "Number of drive motors": "Dual motor", "Total electric motor power (kW)": "360", "Total electric motor torque (N·m)": "720", // ... },
          "Battery/charging": { "Battery capacity (kWh)": "43", "Battery type": "NCM lithium-ion", "Battery cell brand": "CATL", "Vehicle-to-load power (V2L)": "●", // ... },
          "Transmission": { "Number of gears": "1", "Transmission type": "Fixed-ratio transmission" },
          "Chassis/steering": { "Drive type": "awd (dual-motor)", "Front suspension type": "double wishbone independent", "Rear suspension type": "multi-link independent", // ... },
          "Wheels/brakes": { "Front Brake Type": "Ventilated disc", "Front tire size": "255/45 R20", "Parking brake type": "Electronic", // ... },
          "Active safety": { "Anti-lock brakes (ABS)": "●", "Automatic emergency braking": "●", "Blind Spot Monitoring": "●", "Lane Keep Assist": "●", // ... },
          "Driver assistance and handling": { "Parking sensors": "Front, Rear", "Driver assistance level": "Level 2", "Automatic parking": "●", "Air suspension": "●", // ... },
          "Exterior": { "Sunroof type": "Opening panoramic sunroof, Fixed panoramic roof ○ 12999 CNY", "Roof rails": "●", // ... },
          "Seats": { "Seat material": "Leather/suede", "Front seat functions": "Heating, Ventilation, Massage, Memory (driver)", "Rear seat folding ratio": "40:60", // ... },
          "Air conditioning/refrigerator": { "Climate control zones": "2 zones", "PM2.5 Air Filter": "●", "Refrigerator": "○", // ... },
          "...": { ... }  // إجمالاً للفئة 22 مجموعة و252 بنداً
        },
        "images": "[\"http://p3-dcd.byteimg.com/tos-cn-i-dcdx/131c546b47344d22a7cbc915b7186838~tplv-f042mdwyw7-original:640:0.png?psm=motor.pc_car.api\"]",
        "images_360": [
          {
            "inner_id": "101727",
            "color": "Cyan",
            "color_hex": "#B4C1BE",
            "frames": ["https://p9-dcd.byteimg.com/img/tos-cn-i-dcdx/71de1a477ff346e88cec9c287bc53686~tplv-resize:1200:0.webp", "https://p1-dcd.byteimg.com/img/tos-cn-i-dcdx/4d3abdd38939475e97ef1a712f739076~tplv-resize:1200:0.webp", // ...]  // 36 لقطة، دورة كاملة
          },
          // ... إجمالاً 5 مجموعات، واحدة لكل لون من ألوان الهيكل
        ],
        "images_gallery": [
          { "category": "exterior", "inner_id": "101727", "images": ["https://p9-dcd.byteimg.com/motor-mis-img/78ed84c72cb3f6849a27f14cff7b9a7d~tplv-f042mdwyw7-original:1200:0.jpg", // ...] },  // 30 صورة في هذا القسم
          { "category": "interior", "inner_id": "101727", "images": [ ... ] },
          { "category": "space", "inner_id": "101727", "images": [ ... ] }
        ],
        "panorama_interior": [
          {
            "inner_id": "101727",
            "color": "Black",
            "color_hex": "#000000",
            "front": "https://p9-dcd.byteimg.com/img/motor-mis-img/95b71a3d3888109b5525c92a573a73eb~tplv-resize:4000:0.image",
            "rear": "https://p9-dcd.byteimg.com/img/motor-mis-img/cf8bb50227ebe3c9f2ae63e46a95a5ff~tplv-resize:4000:0.image"
          }
        ],
        "section": "new",
        "series_id": "4760",
        "brand_id": "395"
      }
    },
    // ... ثم باقي سجلات الصفحة، حتى 20 سجلاً
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

حقول السجل

• equipment - كائن يضم مجموعات المواصفات والتجهيزات، وأسماء المجموعات أدناه. ولا تضم المجموعة إلا البنود المتوفرة في الفئة. ما تعنيه القيم:
  • ● - موجود في الفئة دون تكلفة إضافية
  • ○ - تجهيز يختاره المشتري؛ والقيمة ⁦"○ 499 CNY"⁩ تبين كم تكلف إضافته
  • نص أو رقم - المقاس أو المادة أو النوع، مثل ⁦"2960"⁩ أو ⁦"Leather/suede"⁩. وتفصل الفاصلة بين نوع وآخر، وتعود العلامة ○ الواردة بعد الاسم عليه، والمبلغ الذي يليها هو التكلفة الإضافية
  • عندما لا تكون للفئة ورقة، تحل سلسلة نصية فارغة محل الكائن
• images - سلسلة نصية تحوي مصفوفة JSON: رابط صورة الطراز. ودون صورة تكون السلسلة فارغة
• images_360 - العرض الدائري للهيكل: مصفوفة مجموعات، مجموعة لكل لون. في المجموعة ⁦inner_id⁩ للفئة التي صُوِّرت، وcolor و⁦color_hex⁩ وframes: 36 لقطة، دورة كاملة حول السيارة؛ وللهيكل ثنائي اللون يُضاف ⁦sub_color_hex⁩. ويأتي اللون الرئيسي أولاً في المصفوفة
• images_gallery - معرض الصور: مصفوفة حسب أقسام التصوير. في العنصر category و⁦inner_id⁩ للفئة التي التُقطت لها الصور وimages، حتى 30 رابطاً. والأقسام: exterior هو الهيكل، وinterior لوحة القيادة بالشاشات والمقود، وspace المقاعد والأبواب وصندوق الأمتعة
• panorama_interior - بانوراما المقصورة. في front وrear وthird عناوين صور كروية بنسبة ⁦2:1⁩: المشهد من مقعد السائق ومن الصف الثاني ومن الصف الثالث، ويغيب third عن بعض السيارات. ويُحدَّد التشطيب الداخلي بـ color و⁦color_hex⁩، والدرجة اللونية الثانية للمقصورة ثنائية اللون في ⁦sub_color_hex⁩. وفي المصفوفة مجموعة لكل لون، وفي المجموعة ⁦inner_id⁩

يبين ⁦inner_id⁩ داخل مجموعة الصور أي فئة صُوِّرت. وقد لا يطابق ID الفئة التي يخصها السجل: أي أن الصور مأخوذة من إصدار آخر من الطراز نفسه. وهكذا تعمل ⁦images_360⁩ و⁦images_gallery⁩ و⁦panorama_interior⁩. وإذا لم تكن لأي فئة من الطراز صور تكون المصفوفات فارغة. كل روابط الصور تؤدي إلى خوادم Dongchedi.

أسماء المجموعات في equipment

equipment - Basic information, Body, Engine, Electric motor, Battery/charging, Transmission, Chassis/steering, Wheels/brakes, Active safety, Passive safety, Driver assistance and handling, Exterior, Interior, Comfort and anti-theft, Seats, Smart connectivity, Infotainment, Lighting, Glass/mirrors, Air conditioning/refrigerator, Intelligent features, Option packages.

GET/change_id

أول ID للأحداث بدءاً من التاريخ المحدد؛ ويُحتسب اليوم بتوقيت الصين. والاستجابة 0 تعني أنه لم تقع أحداث منذ هذا التاريخ بعد.

المعاملات:

• date (مطلوب) - التاريخ بتنسيق yyyy-mm-dd

الاستجابة:

{ "change_id": 14615 }

الاستجابة 0: لا توجد أحداث بعد، فاستدعِ الطريقة مرة أخرى لاحقاً. وأي رقم آخر يصلح للمعامل ⁦change_id⁩.

GET/changes

أحداث الكتالوج: added ظهرت فئة، وchanged تغيّر السعر أو الخصم، وremoved سُحبت فئة من البيع.

المعاملات:

• change_id (مطلوب) - بدءاً من أي معرف تغيير

الاستجابة:

{
  "result": [
    {
      "id": 14615,
      "inner_id": "244341",
      "change_type": "added",
      "created_at": "2026-10-03T09:02:11.648+03:00",
      "data": { ... }  // كل بيانات الفئة كما في ⁦/offers⁩
    },
    {
      "id": 14616,
      "inner_id": "101727",
      "change_type": "changed",
      "created_at": "2026-10-03T09:31:54.072+03:00",
      "data": { "new_price": 246900, "official_price": 266900, "cut_price": 20000 }  // القيم الجديدة لـ price وسعر الشركة المصنعة والخصم
    },
    {
      "id": 14617,
      "inner_id": "101728",
      "change_type": "removed",
      "created_at": "2026-10-03T10:20:37.513+03:00",
      "data": {}  // مثال افتراضي: سُحبت الفئة من البيع
    }
  ],
  "meta": {
    "cur_change_id": 14615,
    "next_change_id": 14618,
    "limit": 20
  }
}

في الاستدعاء التالي مرر ⁦next_change_id⁩ من الاستجابة. والقيمة null تعني أن التدفق قُرئ حتى نهايته: كرر الاستدعاء نفسه بعد فترة.