K Car APIScraper وParser

GET/filters

إرجاع جميع القيم الممكنة للتصفية

الاستجابة:

{
  "mark": {
    "Hyundai": {
      "model": ["Accent", "Avante", "Casper", "Genesis", "Grandeur", "Ioniq", "Kona", "Nexo", "Palisade", "Porter", "Santa Fe", "Sonata", "Starex", "Staria", "Tucson", "Venue", "i40"]
    },
    "Kia": {
      "model": ["Bongo III Truck", "Carnival", "EV3", "EV6", "K3", "K5", "K7", "K8", "K9", "Mohave", "Morning", "Niro", "Pride", "Ray", "Seltos", "Sorento", "Sportage"]
    },
    "Genesis": {
      "model": ["EQ900", "G70", "G80", "G90", "GV70", "GV80"]
    }
    // ... بقية الماركات
  },
  "transmission_type": ["Automatic", "Manual"],
  "color": ["Black", "Blue", "Gray", "Pearl", "Red", "Silver", "Silver Gray", "White", "Yellow"],
  "body_type": ["Bus", "Hatchback", "Minivan", "Pickup", "SUV", "Sedan", "Truck (Double Cab)", "Truck (Regular Cab)", "Truck (Super Cab)", "Van", "Wagon"],
  "engine_type": ["Diesel", "Electric", "Gasoline", "Hybrid (Gasoline)", "Hydrogen", "LPG"],
  "drive_type": ["AWD", "FWD", "RWD"],
  "region": ["Chungbuk", "Chungnam", "Gangwon", "Gyeongbuk", "Gyeonggi/Incheon", "Gyeongnam", "Home Service Mega Center", "Jeonbuk", "Jeonnam", "Seoul"]
}

GET/offers

قائمة الإعلانات مع ترقيم الصفحات والفلاتر

المعاملات:

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

الاستجابة:

{
  "result": [
    {
      "id": 142,
      "inner_id": "EC61380785",
      "change_type": "added",
      "created_at": "2026-09-29T02:49:46.872+03:00",
      "data": {
        "id": "142",
        "inner_id": "EC61380785",
        "url": "https://www.kcar.com/bc/detail/carInfoDtl?i_sCarCd=EC61380785",
        "mark": "Hyundai",
        "model": "Palisade",
        "generation": "The New Palisade",
        "body_configuration": "",
        "configuration": "Gasoline 3.8 2WD",
        "complectation": "Exclusive",
        "title": "Hyundai The New Palisade Gasoline 3.8 2WD Exclusive",
        "year": "2023",
        "price": "27900000",
        "km_age": "25339",
        "color": "White",
        "engine_type": "Gasoline",
        "body_type": "SUV",
        "transmission_type": "Automatic",
        "drive_type": "FWD",
        "displacement": "3778",
        "doors_count": "5",
        "horse_power": "295",
        "vin": "KMHR281EBPU592982",
        "no_accidents": false,
        "equipment": "[\"ABS\", \"Navigation\", \"Leather seats\", \"Alloy wheels\", \"Airbag: side\", \"Power seat: driver\"]",  // في الاستجابة الكاملة 39 إضافة
        "region": "Gyeonggi/Incheon",
        "seller": "K Car Gimpo",
        "salon_id": "087",
        "address": "경기도김포시김포대로1523-1 (장기동) 2동",
        "latitude": "37.658929",
        "longitude": "126.665366",
        "description": "● 차량 연식 대비 주행거리 매우 짧은 차량이며, 컨디션 역시 매우 우수한 차량입니다.<br/>● 신차가 대비 합리적으로 구매 가능한 가성비 추천 차량입니다. ...",
        "offer_created": "2026-06-27",
        "images": "[\"https://img.kcar.com/3dcarpicture/2026/08/087/61380785_2/main/main780.jpg\", \"https://img.kcar.com/3dcarpicture/2026/08/087/61380785_2/extra/extra_0_hq.jpg\"]",  // في الاستجابة الكاملة 40 صورة
        "extra_prep": {
          "first_registration": "2023-03",
          "model_year": 2023,
          "price_base": 28400000,
          "is_discount": true,
          "is_time_deal": false,
          "is_reserved": false,
          "car_class": "SUV",
          "seats": 7,
          "accident_history": "Minor repair",
          "body_damage": {
            "frame": {},
            "exterior": { "bonnet": "repaired", "front-fender-right": "repaired", "front-door-right": "repaired", "back-door-right": "repaired" }
          },
          "insurance_history": {
            "checked_at": "2026-08-10",
            "accidents_count": 3,
            "own_damage_count": 2,
            "own_damage_amount": 771970,
            "other_damage_count": 1,
            "other_damage_amount": 1422584,
            "total_loss_count": 0,
            "flood_count": 0,
            "theft_count": 0,
            "owner_changes_count": 3,
            "plate_changes_count": 0,
            "rental_history": false,
            "business_use_history": false,
            "government_use_history": false,
            "uninsured_periods": "2023-03~2024-05"
          },
          "mileage_history": [
            { "date": "2025-05-29", "km": 16667, "source": "Insurance company" },
            { "date": "2025-04-30", "km": 15993, "source": "K Car" }
          ],
          "badges": ["Low mileage", "Manufacturer warranty", "Driver assistance"],
          "inspection_date": "2026-08-10",
          "views_count": 6054,
          "favorites_count": 53
        }
      }
    }
    // ... بقية السيارات، حتى 20 في الصفحة
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

حقول السجل

داخل extra_prep

GET/change_id

الحصول على أول معرف تغيير حسب التاريخ (للاستخدام في /changes)

المعاملات:

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

الاستجابة:

{ "change_id": 283 }

استخدم القيمة المرجعة كمعامل change_id في /changes

GET/changes

تغذية التغييرات (مضاف/معدل/محذوف)

المعاملات:

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

الاستجابة:

{
  "result": [
    {
      "id": 283,
      "inner_id": "EC61410729",
      "change_type": "added",    // added: عُرضت السيارة للبيع
      "created_at": "2026-09-29T02:58:42.752+03:00",
      "data": { ... }            // السجل كاملاً كما في ⁦/offers⁩
    },
    {
      "id": 284,
      "inner_id": "EC61414869",
      "change_type": "changed",  // changed: السعر الجديد بالوون
      "created_at": "2026-09-29T03:16:53.512+03:00",
      "data": { "new_price": 10200000 }
    },
    {
      "id": 285,
      "inner_id": "EC60843517",
      "change_type": "removed",  // removed: سُحبت السيارة من البيع
      "created_at": "2026-09-29T03:16:54.711+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 283, "next_change_id": 286, "limit": 20 }
}