Autohome APIScraper & Parser

GET/filters

Të dhëna referuese për /offers: markat me modelet e tyre dhe vlerat e filtrave të tjerë. Rindërtohen një herë në ditë. Variantet e arkivuara nuk përfshihen në to, por jepen të gjitha vlerat e filtrit availability.

Përgjigjja:

{
  "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

Variantet e katalogut faqe pas faqeje, me ose pa filtra.

Parametrat:

• page (i detyrueshëm) - numri i faqes
• mark, model - marka dhe modeli, siç shkruhen në /filters
• engine_type, transmission_type, body_type, drive_type - karburanti, transmisioni, lloji i karrocerisë dhe tërheqja, pa dallim midis shkronjave të mëdha dhe të vogla
• availability - statusi i shitjes: on_sale, presale ose offline, me shkronja të vogla, disa vlera të ndara me presje; kur parametri nuk jepet, kthehen on_sale dhe presale
• year_from, year_to - intervali i vitit të modelit
• price_from, price_to - intervali i çmimit në CNY, sipas fushës price

Përgjigjja:

{
  "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": "●", // ... },
          "...": { ... }  // ky variant ka 166 elemente në 16 grupe
        },
        "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 kuadro rreth makinës
          }
        ],
        "images_gallery": [
          { "category": "exterior", "inner_id": "73940", "images": ["https://car2.autoimg.cn/cardfs/product/g34/M08/18/8B/autohomecar__ChtpWGiZmaWALDSGAJghmaxy6as941.jpg", // ...] },  // 20 foto
          { "category": "interior", "inner_id": "73940", "images": [ ... ] },
          // ... pastaj kategoritë space dhe 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 sete të tilla, një për çdo ngjyrë të brendësisë
        ],
        "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", // ... },
            "...": { ... }  // gjithsej 116 specifikime në 8 grupe
          }
          // ... fushat e tjera të extra_prep përshkruhen më poshtë
        }
      }
    },
    // ... dhe rekordet e tjera, 20 për faqe
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Fushat e rekordit

• equipment - pajisjet e ndara sipas grupeve; grupet janë renditur më poshtë. Objekti mban vetëm elementet që i ka ky variant. Si lexohen vlerat:
  • ● - elementi vjen standard te varianti
  • ○ - mund të porositet veçmas; shuma pranë shenjës është kostoja shtesë në CNY, p.sh. "○ 6000 CNY"
  • tekst ose numër - çfarë saktësisht është montuar, p.sh. "Genuine leather" ose "5G". Presjet ndajnë alternativat, dhe shenja ○ vlen për alternativën që është menjëherë para saj: te "Heating, Ventilation, Massage ○" veçmas porositet masazhi
  • vizë - te "front ● / rear -" elementi gjendet përpara dhe mungon prapa; viza nuk shfaqet jashtë një çifti të tillë
  • Një string bosh në vend të objektit do të thotë se pajisjet e variantit nuk dihen
• images - string me një varg JSON brenda: lidhja e fotos së variantit; pa foto string-u është bosh
• images_360 - pamja 360 gradë e karrocerisë. Fusha frames mban 30 ose 36 kuadro për ta shfaqur makinën nga të gjitha anët. Setet ndryshojnë sipas ngjyrës së bojës, të cilën e japin fushat color dhe color_hex; te karroceria me dy ngjyra, secila nga këto dy vlera i rendit të dyja ngjyrat të ndara me vizë të pjerrët, ngjyra kryesore e para. Fusha inner_id e setit tregon cili variant është në kuadro: nëse ky variant nuk është fotografuar, përdoret një variant tjetër i të njëjtit model. Nëse asnjë variant i modelit nuk është fotografuar, vargu është bosh
• images_gallery - fotot sipas kategorive: çdo set ka category, inner_id dhe images, jo më shumë se 20 foto. Kategoritë: exterior për fotot e pjesës së jashtme, interior për panelin e instrumenteve dhe timonin, space për ulëset dhe kabinën, details për fotot nga afër, official për fotot zyrtare të prodhuesit, features për veçoritë dalluese të modelit, auto_show për fotot nga panairet e makinave, night për fotot në errësirë. Galeria është e plotësuar për pjesën më të madhe të katalogut
• panorama_interior - panorama e brendësisë. Një pikë shikimi përbëhet nga gjashtë imazhe: front, back, left, right, up, down, që së bashku formojnë një panoramë kubike. Pozicionet e fotografimit emërtohen me çelësa: front për ulësen e shoferit, passenger për pasagjerin e përparmë, rear për rreshtin e dytë, rear_welfare për rreshtin e dytë me një ulëse për pasagjer me lëvizshmëri të kufizuar, third për rreshtin e tretë, trunk për bagazhin; kthehen vetëm pozicionet që janë fotografuar. Setet grupohen sipas ngjyrës së brendësisë, secili me inner_id, color dhe color_hex. Rreth një e katërta e rekordeve ka panoramë; për të tjerat vargu është bosh

Brenda extra_prep

Në vend të skedarëve, merrni lidhje te serverët e Autohome.

Grupet në përgjigje

• 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-ja e ngjarjes së parë në datën e dhënë ose më vonë. Data merret sipas orës së Kinës. Për sa kohë që nuk ka ngjarje për atë datë, përgjigjja është 0.

Parametrat:

• date (i detyrueshëm) - data në formatin yyyy-mm-dd

Përgjigjja:

{ "change_id": 81984 }

Filloni ta lexoni fluksin nga ID-ja e kthyer: dërgojeni si change_id te /changes. Zero do të thotë se ende nuk ka ngjarje, prandaj kërkojeni ID-në sërish më vonë.

GET/changes

Fluksi i ngjarjeve: një variant i ri (added), një vlerë e re e çmimit ose e statusit të shitjes (changed), një variant i zhdukur nga katalogu i Autohome (removed).

Parametrat:

• change_id (i detyrueshëm) - nga cila ID ndryshimi të fillohet

Përgjigjja:

{
  "result": [
    {
      "id": 81984,
      "inner_id": "73940",
      "change_type": "added",
      "created_at": "2026-10-03T08:14:22.317+03:00",
      "data": { ... }  // i gjithë rekordi, si në përgjigjen e /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" }  // pas ndryshimit: vlera e fushës price, çmimi i prodhuesit dhe statusi i shitjes
    },
    {
      "id": 81986,
      "inner_id": "47831",
      "change_type": "removed",
      "created_at": "2026-10-03T08:17:41.205+03:00",
      "data": {}  // shembull hipotetik: varianti është zhdukur nga katalogu i Autohome
    }
  ],
  "meta": {
    "cur_change_id": 81984,
    "next_change_id": 81987,
    "limit": 20
  }
}

Dërgoni next_change_id në kërkesën tjetër. Nëse është null, ende nuk ka ngjarje të reja: përsëriteni të njëjtën kërkesë më vonë. Në fluks hyjnë edhe ngjarjet e varianteve të arkivuara.