Autohome APIScraper وParser

GET/filters

مرجع ⁦/offers⁩: الماركات مع طرازاتها وقيم باقي الفلاتر. يُعاد بناؤه مرة يومياً. ولا تدخل فيه الفئات المؤرشفة، لكن قيم availability مدرجة فيه كلها.

الاستجابة:

{
  "mark": {
    "Tank": {
      "model": ["Tank 300", "Tank 300 New Energy", "Tank 300L New Energy", "Tank 400", "Tank 400 New Energy", "Tank 500", "Tank 500 New Energy", "Tank 700 New Energy"]
    },
    "Toyota": {
      "model": ["Alphard", "Avalon", "Camry", "Coaster", "Corolla", "Corolla Cross", // ...]
    },
    "...": { ... }
  },
  "engine_type": ["diesel", "electric", "gasoline", "hybrid", "plug-in hybrid", "range extender", // ...],
  "transmission_type": ["automatic", "manual"],
  "body_type": ["coupe", "crossover", "hatchback", "liftback", "minivan", "pickup", "sedan", "suv", "wagon", // ...],
  "drive_type": ["awd (dual-motor)", "awd (front-engine)", "fwd", "rwd (rear-engine)", // ...],
  "availability": ["offline", "on_sale", "presale"]
}

GET/offers

فئات الكتالوج صفحةً بعد صفحة، بفلاتر أو بدونها.

المعاملات:

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

الاستجابة:

{
  "result": [
    {
      "id": 77257,
      "inner_id": "73940",
      "change_type": "added",
      "created_at": "2026-10-01T23:28:45.074+03:00",
      "data": {
        "id": "77257",
        "inner_id": "73940",
        "url": "https://www.autohome.com.cn/spec/73940/",
        "mark": "Tank",
        "model": "Tank 500 New Energy",
        "complectation": "2026 Hi4-Z Smart Edition",
        "title": "Tank 500 NEV 2026 Hi4-Z Smart Edition",
        "year": "2026",
        "price": "375000",
        "official_price": "375000",
        "cut_price": "0",
        "availability": "on_sale",
        "sale_status": "20",
        "engine_type": "plug-in hybrid",
        "transmission_type": "automatic",
        "drive_type": "awd (front-engine)",
        "body_type": "suv",
        "level": "full-size suv",
        "displacement": "2.0",
        "doors_count": "5",
        "seats": "5",
        "horse_power": "864",
        "ice_power_ps": "252",
        "ice_power_kw": "185",
        "electric_power_ps": "619",
        "electric_power_kw": "455",
        "hybrid_power_ps": "864",
        "hybrid_power_kw": "635",
        "equipment": {
          "Active safety": { "Anti-lock brakes (ABS)": "●", "Door Open Warning (DOW)": "●", "Forward collision warning": "●", "Driver fatigue alert": "●", "Tire pressure monitoring": "Tire Pressure Display", // ... },
          "Passive safety": { "Driver/front passenger airbags": "driver ● / passenger ●", "Front/Rear Side Airbags": "front ● / rear -", "Front/rear curtain airbags": "front ● / rear ●" },
          "Driving features": { "Cruise Control System": "Full-speed adaptive cruise control", "Blind Spot Monitoring": "●", "Memory parking": "●", "Night vision system": "○ 6000 CNY", "Remote parking": "○", // ... },
          "Driver assistance hardware": { "Number of cameras": "11, 12 ○", "Number of lidars": "1", "LiDAR Brand": "HESAI", "Number of millimeter-wave radars": "3", // ... },
          "AWD/off-road": { "Low-range 4WD (4L)": "●", "Tank turn": "●", "Tow hitch": "Manual ○", // ... },
          "Seats": { "Seat material": "Genuine leather", "Second row seat features": "Heating, Ventilation, Massage ○", "Rear seat folding": "Split-Folding", // ... },
          "Air conditioning/refrigerator": { "Climate control type": "Automatic Climate Control", "Refrigerator": "●", "PM2.5 Air Filter": "●", // ... },
          "Connectivity and smart features": { "4G/5G network": "5G", "Over-the-Air Updates": "●", "Wi-Fi hotspot": "●", // ... },
          "...": { ... }  // في هذه الفئة 166 بنداً في 16 مجموعة
        },
        "images": "[\"https://car2.autoimg.cn/cardfs/product/g33/M06/28/5F/autohomecar__ChxpVmiDH_6ALcX2ACclsalYMLA998.jpg\"]",
        "images_360": [
          {
            "inner_id": "73940",
            "color": "Silver",
            "color_hex": "#C2C5CA",
            "frames": ["https://panovr.autoimg.cn/pano/g33/M0B/54/2D/1200x0_autohomecar__Chto52iG3R-AeZfUAB2qZPzvwGE530.png.webp", "https://panovr.autoimg.cn/pano/g33/M08/54/2E/1200x0_autohomecar__Chto52iG3SKALWDLABpsFKT3f88009.png.webp", // ...]  // 30 لقطة حول السيارة
          }
        ],
        "images_gallery": [
          { "category": "exterior", "inner_id": "73940", "images": ["https://car2.autoimg.cn/cardfs/product/g34/M08/18/8B/autohomecar__ChtpWGiZmaWALDSGAJghmaxy6as941.jpg", // ...] },  // 20 صورة
          { "category": "interior", "inner_id": "73940", "images": [ ... ] },
          // ... ثم قسما space وdetails
        ],
        "panorama_interior": [
          {
            "inner_id": "73940",
            "color": "Black",
            "color_hex": "#000000",
            "front": {
              "front": "https://panovr.autoimg.cn/pano/pub/ma/dspm/41661/vr/pano_f.jpg",
              "back": "https://panovr.autoimg.cn/pano/pub/ma/dspm/41661/vr/pano_b.jpg",
              "left": "https://panovr.autoimg.cn/pano/pub/ma/dspm/41661/vr/pano_l.jpg",
              "right": "https://panovr.autoimg.cn/pano/pub/ma/dspm/41661/vr/pano_r.jpg",
              "up": "https://panovr.autoimg.cn/pano/pub/ma/dspm/41661/vr/pano_u.jpg",
              "down": "https://panovr.autoimg.cn/pano/pub/ma/dspm/41661/vr/pano_d.jpg"
            },
            "rear": { ... },
            "trunk": { ... }
          },
          // ... 3 مجموعات كهذه، بعدد ألوان المقصورة
        ],
        "section": "new",
        "series_id": "6653",
        "brand_id": "458",
        "extra_prep": {
          "price_source": "dealer",
          "dealer_price": 375000,
          "price_city": "Beijing",
          "factory": "Great Wall",
          "factory_id": 4,
          "brand_logo": "https://car2.autoimg.cn/cardfs/series/g26/M03/1D/1A/autohomecar__ChxkjmTIojGAGUXzAAGMAXtqVb0993.png",
          "brand_country": "China",
          "is_popular": true,
          "series_state": 20,
          "spec_group": "2.0 L Turbocharged 252 hp",
          "spec_description": "awd (front-engine) 3-speed DHT",
          "is_config_missing": false,
          "market_date": "2025-08-27",
          "emission_standard": "China VI",
          "engine": "2.0T 252 hp L4",
          "engine_model": "E20NB",
          "displacement_ml": 1998,
          "intake": "Turbocharged",
          "cylinders": 4,
          "fuel_grade": "RON 92",
          "max_power_kw": 635,
          "max_torque_nm": 1195,
          "transmission": "3-speed DHT",
          "gears": "3",
          "transmission_kind": "Dedicated hybrid transmission (DHT)",
          "awd_type": "Electric AWD",
          "body": "5-door 5-seat SUV",
          "length_mm": 5078,
          "width_mm": 1934,
          "height_mm": 1905,
          "wheelbase_mm": 2850,
          "ground_clearance_mm": 210,
          "curb_weight_kg": 2980,
          "gross_weight_kg": 3430,
          "fuel_tank_l": 77,
          "trunk_l": 1489,
          "max_speed_kmh": 180,
          "acceleration_0_100_s": 4.3,
          "fuel_consumption_wltc": 0.85,
          "battery_kwh": 59.05,
          "battery_type": "NCM lithium-ion",
          "range_wltc_km": 201,
          "electricity_kwh_100km": 27.3,
          "fast_charge_kw": 163,
          "fast_charge_hours": 0.25,
          "motor_type": "Permanent magnet synchronous",
          "motors_count": "Dual motor",
          "warranty": "5 years or 150,000 km",
          "tires_front": "265/55 R19, 265/50 R20 ○ 5000 CNY, 265/60 R18 ○ 5000 CNY",
          "tires_rear": "265/55 R19, 265/50 R20 ○, 265/60 R18 ○",
          "colors": {
            "exterior": [{ "name": "Silver", "value": "#C2C5CA", "picnum": 170, "colorid": 9697 }, // ...],
            "interior": [ ... ]
          },
          "packages": [{ "name": "Outdoor Leisure Package", "price": "3000 CNY", "value": "○", "content": "..." }, // ...],
          "params": {
            "Body": { "Length (mm)": "5078", "Wheelbase (mm)": "2850", "Approach angle (°)": "29", // ... },
            "Electric motor": { "Number of drive motors": "Dual motor", "Total electric motor power (kW)": "455", // ... },
            "Battery/charging": { "Battery capacity (kWh)": "59.05", "Battery cell brand": "SVOLT", "Fast charging power (kW)": "163", // ... },
            "...": { ... }  // إجمالاً 116 مواصفة في 8 مجموعات
          }
          // ... باقي حقول ⁦extra_prep⁩ مذكورة في الوصف أدناه
        }
      }
    },
    // ... وبقية السجلات، وعددها في الصفحة 20
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

حقول السجل

• equipment - التجهيزات موزعة على مجموعات؛ والمجموعات مذكورة أدناه. ولا يضم الكائن إلا البنود المتوفرة في الفئة. كيف تُقرأ القيم:
  • ● - البند ضمن التجهيزات القياسية للفئة
  • ○ - يمكن طلبه على حدة؛ والمبلغ المجاور هو التكلفة الإضافية باليوان، مثل ⁦"○ 6000 CNY"⁩
  • نص أو رقم - النوع المحدد للبند، مثل ⁦"Genuine leather"⁩ أو ⁦"5G"⁩. وتفصل الفاصلة بين العناصر، وتعود العلامة ○ على العنصر الذي قبلها: ففي ⁦"Heating, Ventilation, Massage ○"⁩ يُطلب التدليك على حدة
  • شرطة - في القيمة ⁦"front ● / rear -"⁩ التجهيز موجود في الأمام وغائب في الخلف؛ ولا ترد الشرطة إلا ضمن زوج كهذا
  • سلسلة نصية فارغة مكان الكائن تعني أن تجهيزات الفئة غير معروفة
• images - سلسلة نصية تحوي مصفوفة JSON: رابط صورة الفئة؛ وتكون السلسلة فارغة دون صورة
• images_360 - العرض الدائري للهيكل. في frames 30 أو 36 لقطة لعرض السيارة من كل الجهات. وتختلف المجموعات بلون الطلاء الذي يحدده color و⁦color_hex⁩، وفي الهيكل ثنائي اللون يُكتب اللونان في كل من القيمتين مفصولين بشرطة مائلة، واللون الرئيسي أولاً. ويبين ⁦inner_id⁩ الخاص بالمجموعة أي فئة تظهر في اللقطات: فإذا لم تُصوَّر الفئة نفسها تؤخذ فئة أخرى من الطراز نفسه. وإذا لم تُصوَّر أي فئة من الطراز تكون المصفوفة فارغة
• images_gallery - الصور حسب الأقسام: في كل مجموعة category و⁦inner_id⁩ وimages، بما لا يزيد على 20 صورة. والأقسام: exterior المظهر الخارجي، وinterior لوحة القيادة والمقود، وspace المقاعد والمقصورة، وdetails التفاصيل الصغيرة، وofficial الصور الرسمية من الشركة المصنعة، وfeatures مزايا الطراز، و⁦auto_show⁩ لقطات من معارض السيارات، وnight التصوير في الظلام. ومعرض الصور متوفر لمعظم الكتالوج
• panorama_interior - بانوراما المقصورة. الزاوية الواحدة ست صور: front وback وleft وright وup وdown، وتشكل معاً بانوراما مكعبة. ونقاط التصوير مسماة بالمفاتيح: front السائق، وpassenger الراكب الأمامي، وrear الصف الثاني، و⁦rear_welfare⁩ الصف الثاني بمقعد لراكب محدود الحركة، وthird الصف الثالث، وtrunk صندوق الأمتعة؛ ولا تصل إلا النقاط المصوَّرة. والمجموعات مصنفة حسب لون التشطيب الداخلي، وفي كل منها ⁦inner_id⁩ وcolor و⁦color_hex⁩. والبانوراما متوفرة لنحو ربع السجلات، وفي الباقي تكون المصفوفة فارغة

داخل extra_prep

بدلاً من الملفات تصل روابط إلى خوادم Autohome.

المجموعات التي تصل

• equipment - Active safety, Passive safety, Driving features, Driver assistance hardware, Handling, AWD/off-road, Exterior/anti-theft, Exterior lighting, Exterior mirrors, Sunroof/Glass, Seats, Steering wheel/interior mirror, Air conditioning/refrigerator, In-car charging, Connectivity and smart features, Audio/interior lighting, Special features.
• extra_prep.params - Basic Parameters, Body, Engine, Transmission, Electric motor, Battery/charging, Chassis & Steering, Wheels and brakes.

GET/change_id

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

المعاملات:

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

الاستجابة:

{ "change_id": 81984 }

ابدأ قراءة التدفق باستخدام ID الذي حصلت عليه: مرره في ⁦change_id⁩ لطريقة ⁦/changes⁩. والصفر يعني أنه لا توجد أحداث بعد، فاطلب ID لاحقاً.

GET/changes

تدفق الأحداث: فئة جديدة (added)، وقيمة جديدة للسعر أو لحالة البيع (changed)، والخروج من كتالوج المنصة (removed).

المعاملات:

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

الاستجابة:

{
  "result": [
    {
      "id": 81984,
      "inner_id": "73940",
      "change_type": "added",
      "created_at": "2026-10-03T08:14:22.317+03:00",
      "data": { ... }  // السجل كاملاً كما في استجابة ⁦/offers⁩
    },
    {
      "id": 81985,
      "inner_id": "74935",
      "change_type": "changed",
      "created_at": "2026-10-03T08:15:06.940+03:00",
      "data": { "new_price": 210800, "official_price": 249800, "availability": "on_sale" }  // بعد التغيير: قيمة price وسعر الشركة المصنعة وحالة البيع
    },
    {
      "id": 81986,
      "inner_id": "47831",
      "change_type": "removed",
      "created_at": "2026-10-03T08:17:41.205+03:00",
      "data": {}  // مثال افتراضي: اختفت الفئة من كتالوج المنصة
    }
  ],
  "meta": {
    "cur_change_id": 81984,
    "next_change_id": 81987,
    "limit": 20
  }
}

مرر ⁦next_change_id⁩ في الطلب التالي. وإذا كان مساوياً null فلا توجد أحداث جديدة بعد: أعد الطلب السابق لاحقاً. وتدخل أحداث الفئات المؤرشفة في التدفق أيضاً.