واجهة برمجية لإعلانات السيارات من Encar وMobile.de وChe168 وDongchedi والمزيد

EncarMobile.deAutoScout24Che168GuaziDongchedi+9 منصة أخرى

بيانات إعلانات السيارات الآنية واليومية بواجهة واحدة. راقب الإعلانات الجديدة وتغيرات الأسعار والنشر والإزالة لحظياً من كل المنصات.

جرب الواجهة البرمجية الآنعرض التوثيقيتم توفير الوصول خلال دقيقتين
100M+
إعلان
15+
منصة
50+
حقل بيانات
وقت الاستجابة<200ms
حالة الواجهة
يعمل
API Reference

الرابط الأساسي

https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}

التفويض: api_key parameter

سير العمل

1
/filtersالحصول على قيم الفلتر المتاحة
2
/offersالحصول على القوائم (مع أو بدون فلاتر) - استخدم للتحميل الأولي للبيانات
3

للتحديثات (الحفاظ على تحديث البيانات بعد التحميل الأولي):

/change_id?date=...الحصول على معرف البداية لتغذية التغييرات
/changes?change_id=...الحصول على جميع التغييرات في قاعدة البيانات بدءاً من المعرف
4
/offerالحصول على تفاصيل قائمة محددة بواسطة inner_id

نهج التكامل الموصى به:

1. أولاً، استخدم /offers لجلب البيانات الأولية (تصفح جميع الصفحات)

2. ثم استخدم /changes للحصول الدوري على جميع التغييرات (المضافة/المعدّلة/المحذوفة) لمزامنة قاعدة بياناتك المحلية مع المصدر

3. لدمج البيانات في موقعك الإلكتروني، يمكنك استخدام /offers مع الفلاتر والتصفح (العلامة التجارية، الطراز، السعر، السنة، إلخ)

GET/filters

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

https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEY

الاستجابة:

{
  "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 - filters (غير حساس لحالة الأحرف)
  • transmission_type, color, body_type, engine_type - filters (غير حساس لحالة الأحرف)
  • year_from, year_to - فلتر نطاق السنوات
  • km_age_from, km_age_to - فلتر نطاق المسافة المقطوعة
  • price_from, price_to - فلتر نطاق الأسعار (بوحدات 10,000 وون كوري)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=black

الاستجابة:

{
  "result": [
    {
      "id": 3219435,
      "inner_id": "40427050",
      "change_type": "added",
      "created_at": "2025-09-08T12:02:03.000Z",
      "data": {
        "id": 1454012,
        "inner_id": "40427050",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
        "mark": "Hyundai",
        "model": "Palisade",
        "generation": "Diesel 2.2 4WD",
        "configuration": "Diesel 2.2 4WD",
        "complectation": "Prestige",
        "year": 2021,
        "color": "Black",
        "price": 3190,
        "price_won": "31900000",
        "km_age": 92842,
        "engine_type": "Diesel",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "address": "Busan Gijang-gun",
        "seller_type": "DEALER",
        "is_dealer": true,
        "images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
        "extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

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

  • id - معرف قاعدة البيانات الداخلي
  • inner_id - معرف الإعلان على المنصة
  • url - رابط الإعلان
  • mark - ماركة السيارة
  • model - موديل السيارة
  • generation - الجيل
  • configuration - التكوين
  • complectation - مستوى التجهيز
  • year - سنة الإنتاج
  • color - اللون
  • price - السعر (بوحدات 10,000 وون كوري)
  • price_won - السعر الكامل بالوون الكوري
  • km_age - المسافة المقطوعة بالكيلومتر
  • engine_type - نوع المحرك
  • transmission_type - نوع ناقل الحركة
  • body_type - نوع الهيكل
  • address - العنوان
  • seller_type - نوع البائع
  • is_dealer - علامة الوكيل (true/false)
  • section - القسم
  • seller - البائع
  • salon_id - معرف الوكيل
  • description - الوصف
  • displacement - سعة المحرك (cc)
  • offer_created - تاريخ إنشاء الإعلان
  • images - مصفوفة روابط الصور
  • extra - بيانات إضافية (JSON)
  • options - قائمة الخيارات

GET/change_id

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

المعاملات:

  • date (مطلوب) - التاريخ بتنسيق yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15

الاستجابة:

{ "change_id": 1547283 }

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

GET/changes

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

المعاملات:

  • change_id (مطلوب) - بدءاً من أي معرف تغيير
https://{access_name}.auto-api.com/api/v2/{platform}/changes?api_key=YOUR_API_KEY&change_id=1

الاستجابة:

{
  "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 }
    },
    {
      "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 (مطلوب)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050

الاستجابة: كائن data (مثل /offers، ولكن بدون غلاف result)

احصل على القائمة بواسطة الرابط

استرجع بيانات القائمة الكاملة من خلال توفير الرابط الأصلي من أي منصة مدعومة. مثالي لعمليات البحث السريعة واسترجاع قائمة واحدة.

الرابط الأساسي

https://{access_name}.auto-api.com/api/v1/offer/info

الترخيص عبر رأس x-api-key

POST/api/v1/offer/info

أرسل طلب POST مع رابط القائمة للحصول على البيانات الكاملة

المعاملات:

  • url (مطلوب) - رابط القائمة على أي منصة مدعومة

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

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=39225419" }'

الاستجابة:

{
  "inner_id": "39225419",
  "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
  "mark": "BMW",
  "model": "5-Series",
  "generation": "528i",
  "year": 2010,
  "year_month": "2010-08",
  "color": "Silver",
  "price": 880,
  "price_won": 8800000,
  "km_age": 132437,
  "engine_type": "Gasoline",
  "transmission_type": "Automatic",
  "body_type": "Sedan",
  "displacement": "2996",
  "power": "230",
  "vin": "WBAFR1105AC258998",
  "address": "Gwangju Seo-gu",
  "seller_type": "DEALER",
  "is_dealer": true,
  "offer_created": "2025-11-17",
  "images": [
    "https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
    "https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
  ]
}

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

  • inner_id - معرف الإعلان على المنصة
  • url - رابط الإعلان
  • mark - ماركة السيارة
  • model - موديل السيارة
  • generation - الجيل
  • year - سنة الإنتاج
  • year_month - سنة وشهر الإنتاج
  • color - اللون
  • price - السعر بوحدات 10000 وون كوري
  • km_age - المسافة المقطوعة بالكيلومتر
  • engine_type - نوع المحرك
  • transmission_type - نوع ناقل الحركة
  • body_type - نوع الهيكل
  • displacement - سعة المحرك (سم مكعب)
  • power - القدرة بالحصان
  • vin - رمز VIN
  • address - العنوان
  • seller_type - نوع البائع
  • is_dealer - علامة الوكيل (true/false)
  • offer_created - تاريخ إنشاء الإعلان
  • images - مصفوفة روابط الصور
التصديرات اليومية

سياسة الاحتفاظ بالبيانات

الملفات مخزنة لمدة 3 أيام على الأقل

جدول توافر الواجهة البرمجية

ملفات يومية جديدة متاحة للتنزيل

تنسيق بيانات CSV

ملفات CSV تستخدم الأنبوب (|) كفاصل أعمدة

بنية الرابط:

https://{access_name}.auto-api.com/{date}/{file_name}

معاملات الطلب:

  • access_name - معرف النطاق الفرعي المخصص لك
  • date - التاريخ المطلوب بتنسيق yyyy-mm-dd (مثال: 2025-09-06)
  • file_name - اسم ملف التصدير مع الامتداد

التنسيقات المتاحة:

  • CSV - all_active.csv, new_daily.csv, removed_daily.csv
  • JSON - all_active.json, new_daily.json, removed_daily.json
  • Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

مثال طلب cURL API

curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

أمر تحميل Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
ميزات API

تكامل البيانات

جمع إعلانات السيارات من منصات متعددة في الوقت الفعلي.

معالجة آنية

أحدث أسعار السيارات والتوافر والمواصفات مع تحديثات فورية.

تحليلات السوق

بيانات سوق تفصيلية تتيح التحليلات ورؤى بحثية.

حلول للمؤسسات

خدمات قابلة للتطوير مع حلول بيانات مخصصة لاحتياجات عملك.

تغطية عالمية

الوصول إلى بيانات السيارات من الأسواق الرئيسية بما في ذلك أوروبا وأمريكا الشمالية وآسيا.

مناسبة للمطورين

واجهة برمجية RESTful مع توثيق وأمثلة على الأكواد.