Encar APIScraper & Parser

GET/filters

إرجاع جميع خيارات الفلترة المتاحة وقيمها الممكنة

الاستجابة:

{
  "mark": {
    "Hyundai": {
      "model": {
        "Sonata": {
          "configuration": {
            "DN8": { "complectation": ["Smart", "Modern", "Premium"] }
          }
        }
      }
    },
    "Kia": {
      "model": {
        "K5": {
          "configuration": {
            "DL3": { "complectation": ["LX", "EX", "SX"] }
          }
        }
      }
    }
  },
  "transmission_type": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
  "color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
  "body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
  "engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}

GET/offers

إعلانات المركبات مع دعم ترقيم الصفحات وإمكانيات التصفية

المعاملات:

• page (مطلوب) - رقم الصفحة
• mark, model, configuration, complectation - فلاتر (غير حساس لحالة الأحرف)
• transmission_type, color, body_type, engine_type - فلاتر (غير حساس لحالة الأحرف)
• year_from, year_to - فلتر نطاق السنوات
• km_age_from, km_age_to - فلتر نطاق المسافة المقطوعة
• price_from, price_to - فلتر نطاق الأسعار (بوحدات 10000 وون كوري)

الاستجابة:

{
  "result": [
    {
      "id": 2123939,
      "inner_id": "41449755",
      "change_type": "added",
      "created_at": "2026-02-04T02:39:02.000Z",
      "data": {
        "id": 2123939,
        "inner_id": "41449755",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=41449755",
        "mark": "Mercedes-Benz",
        "model": "GLE-Class",
        "generation": "GLE450 4MATIC",
        "configuration": "GLE450 4MATIC",
        "year": 2019,
        "color": "Black",
        "price": 5290,
        "price_won": "52900000",
        "km_age": 97986,
        "engine_type": "Gasoline",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "displacement": "2999",
        "power": "367",
        "power_ice_hp": "367",
        "power_electro_kw": "16",
        "address": "Gyeonggi Suwon-si",
        "seller_type": "DEALER",
        "is_dealer": true,
        "images": ["https://ci.encar.com/carpicture04/pic4144/41449755_027.jpg"],
        "extra": {"diagnosis": {...}, "inspection": {...}, "record_open": {...}}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

حقول البيانات:

GET/change_id

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

المعاملات:

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

الاستجابة:

{ "change_id": 8471926 }

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

GET/changes

تدفق التغييرات في الوقت الفعلي (إعلانات جديدة/تحديثات أسعار/إزالات)

المعاملات:

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

الاستجابة:

{
  "result": [
    {
      "id": 456,
      "inner_id": "40427050",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "40427051",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 3490, "new_price_won": 34900000 }
    },
    {
      "id": 458,
      "inner_id": "40427052",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2025-01-15T10:32:00Z"
    }
  ],
  "meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}

GET/offer

التفاصيل الكاملة لإعلان واحد بواسطة inner_id

المعاملات:

• inner_id (مطلوب)

الاستجابة: كائن data (هيكل مطابق لعناصر /offers، بدون غلاف مصفوفة result)

POST/api/v1/offer/info

الحصول على بيانات الإعلان من encar.com عبر الرابط

المعاملات:

• url (مطلوب) - link to the listing on encar.com

مثال على الطلب:

curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=41449755" }'

الاستجابة:

{
  "inner_id": "41449755",
  "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=41449755",
  "mark": "Mercedes-Benz",
  "model": "GLE-Class",
  "generation": "GLE450 4MATIC",
  "year": 2019,
  "year_month": "2019-09",
  "color": "Black",
  "price": 5290,
  "price_won": 52900000,
  "km_age": 97986,
  "engine_type": "Gasoline",
  "transmission_type": "Automatic",
  "body_type": "SUV",
  "displacement": "2999",
  "power": "367",
  "power_ice_hp": "367",
  "power_electro_kw": "16",
  "vin": "WDCFB5KB6KA066821",
  "address": "Gyeonggi Suwon-si",
  "seller_type": "DEALER",
  "is_dealer": true,
  "offer_created": "2026-02-04",
  "images": [
    "https://ci.encar.com/carpicture04/pic4144/41449755_027.jpg",
    "https://ci.encar.com/carpicture04/pic4144/41449755_002.jpg"
  ]
}

وصف الحقول: