Autohome APIScraper i parser

GET/filters

Słownik dla /offers: marki z modelami i wartości pozostałych filtrów. Przebudowywany raz na dobę. Wersje archiwalne nie wchodzą w jego skład. Mimo to wszystkie wartości availability są w nim wymienione.

Odpowiedź:

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

Wersje wyposażenia z katalogu strona po stronie, z filtrami lub bez.

Parametry:

• page (wymagane) - numer strony
• mark, model - marka i model w pisowni z /filters
• engine_type, transmission_type, body_type, drive_type - paliwo, skrzynia biegów, nadwozie i napęd, bez rozróżniania wielkości liter
• availability - status sprzedaży: on_sale, presale lub offline, małymi literami, kilka wartości po przecinku; jeśli parametr nie jest podany, przychodzą on_sale i presale
• year_from, year_to - zakres roku modelowego
• price_from, price_to - zakres ceny w juanach według pola price

Odpowiedź:

{
  "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": "●", // ... },
          "...": { ... }  // w tej wersji 166 pozycji w 16 grupach
        },
        "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 ujęć dookoła auta
          }
        ],
        "images_gallery": [
          { "category": "exterior", "inner_id": "73940", "images": ["https://car2.autoimg.cn/cardfs/product/g34/M08/18/8B/autohomecar__ChtpWGiZmaWALDSGAJghmaxy6as941.jpg", // ...] },  // 20 zdjęć
          { "category": "interior", "inner_id": "73940", "images": [ ... ] },
          // ... dalej kategorie space i 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": { ... }
          },
          // ... takich zestawów jest 3, tyle co kolorów wnętrza
        ],
        "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", // ... },
            "...": { ... }  // łącznie 116 parametrów w 8 grupach
          }
          // ... pozostałe pola extra_prep są wymienione w opisie niżej
        }
      }
    },
    // ... i pozostałe rekordy, na stronie jest ich 20
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Pola rekordu

• equipment - wyposażenie rozłożone na grupy; grupy są wymienione niżej. W obiekcie są tylko te pozycje, które ma dana wersja. Jak czytać wartości:
  • ● - pozycja wchodzi w skład wyposażenia standardowego wersji
  • ○ - można zamówić osobno; kwota obok to dopłata w juanach, np. "○ 6000 CNY"
  • tekst lub liczba - konkretne wykonanie, np. "Genuine leather" lub "5G". Przecinek rozdziela warianty, znak ○ odnosi się do wariantu przed nim: w "Heating, Ventilation, Massage ○" osobno zamawia się masaż
  • kreska - w zapisie "front ● / rear -" wyposażenie jest z przodu, a z tyłu go nie ma; poza taką parą kreska nie występuje
  • Pusty ciąg znaków zamiast obiektu oznacza, że wyposażenie wersji jest nieznane
• images - ciąg znaków z tablicą JSON w środku: link do zdjęcia wersji wyposażenia; bez zdjęcia ciąg jest pusty
• images_360 - widok 360° nadwozia. W frames jest 30 lub 36 ujęć pokazujących auto dookoła. Zestawy różnią się lakierem: określają go color i color_hex, przy dwukolorowym nadwoziu obie wartości zawierają dwa kolory rozdzielone ukośnikiem, kolor główny jako pierwszy. Po inner_id zestawu widać, która wersja wyposażenia jest na ujęciach: jeśli danej wersji nie sfotografowano, brana jest inna z tego samego modelu. Jeśli cały model nie ma takich zdjęć, tablica jest pusta
• images_gallery - zdjęcia według kategorii: w każdym zestawie category, inner_id i images, nie więcej niż 20 zdjęć. Kategorie: exterior wygląd zewnętrzny, interior deska rozdzielcza i kierownica, space fotele i wnętrze, details drobne detale, official oficjalne zdjęcia producenta, features cechy szczególne modelu, auto_show ujęcia z targów motoryzacyjnych, night zdjęcia po zmroku. Galerię ma większa część katalogu
• panorama_interior - panorama wnętrza. Jedna pozycja kamery to sześć obrazów: front, back, left, right, up, down, razem dają panoramę sześcienną. Pozycje kamery są nazwane kluczami: front kierowca, passenger pasażer z przodu, rear drugi rząd, rear_welfare drugi rząd z fotelem dla pasażera o ograniczonej sprawności ruchowej, third trzeci rząd, trunk bagażnik; przychodzą tylko te, które sfotografowano. Zestawy są pogrupowane według koloru wykończenia, w każdym inner_id, color i color_hex. Panoramę ma mniej więcej jedna czwarta rekordów, w pozostałych tablica jest pusta

Zawartość extra_prep

Zamiast plików przychodzą linki do serwerów Autohome.

Jakie grupy przychodzą

• 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 pierwszego zdarzenia z podanej daty lub późniejszego. Datę przyjmuje się według czasu chińskiego. Dopóki nie ma zdarzeń z tej daty, w odpowiedzi jest 0.

Parametry:

• date (wymagane) - data w formacie yyyy-mm-dd

Odpowiedź:

{ "change_id": 81984 }

Od otrzymanego ID zacznij odczyt strumienia: przekaż go w change_id metody /changes. Zero oznacza, że zdarzeń jeszcze nie ma: pobierz ID później.

GET/changes

Strumień zdarzeń: nowa wersja wyposażenia (added), nowa wartość ceny lub statusu sprzedaży (changed), zniknięcie z katalogu platformy (removed).

Parametry:

• change_id (wymagane) - od którego ID zmiany

Odpowiedź:

{
  "result": [
    {
      "id": 81984,
      "inner_id": "73940",
      "change_type": "added",
      "created_at": "2026-10-03T08:14:22.317+03:00",
      "data": { ... }  // cały rekord, jak w odpowiedzi /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" }  // po zmianie: wartość price, cena producenta i status sprzedaży
    },
    {
      "id": 81986,
      "inner_id": "47831",
      "change_type": "removed",
      "created_at": "2026-10-03T08:17:41.205+03:00",
      "data": {}  // przykład poglądowy: wersja zniknęła z katalogu platformy
    }
  ],
  "meta": {
    "cur_change_id": 81984,
    "next_change_id": 81987,
    "limit": 20
  }
}

W kolejnym żądaniu przekaż next_change_id. Jeśli ma wartość null, nowych zdarzeń jeszcze nie ma: powtórz to samo żądanie później. Zdarzenia wersji archiwalnych też trafiają do strumienia.