Autohome APIScraper e parser

GET/filters

Tabela de referência para /offers: marcas com os seus modelos e valores dos restantes filtros. É regenerada uma vez por dia. As versões em arquivo não entram nela. Ainda assim, os valores de availability estão todos listados.

Resposta:

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

Versões do catálogo, página a página, com ou sem filtros.

Parâmetros:

• page (obrigatório) - número da página
• mark, model - marca e modelo, escritos como em /filters
• engine_type, transmission_type, body_type, drive_type - combustível, caixa, carroçaria e tração, sem distinção de maiúsculas
• availability - estado de venda: on_sale, presale ou offline, em minúsculas, vários valores separados por vírgulas; sem o parâmetro, vêm on_sale e presale
• year_from, year_to - intervalo do ano-modelo
• price_from, price_to - intervalo de preço em yuans, pelo campo price

Resposta:

{
  "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": "●", // ... },
          "...": { ... }  // esta versão tem 166 itens em 16 grupos
        },
        "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 imagens à volta do carro
          }
        ],
        "images_gallery": [
          { "category": "exterior", "inner_id": "73940", "images": ["https://car2.autoimg.cn/cardfs/product/g34/M08/18/8B/autohomecar__ChtpWGiZmaWALDSGAJghmaxy6as941.jpg", // ...] },  // 20 fotos
          { "category": "interior", "inner_id": "73940", "images": [ ... ] },
          // ... seguem-se as categorias space e 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": { ... }
          },
          // ... há 3 conjuntos destes, um por cor do interior
        ],
        "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", // ... },
            "...": { ... }  // ao todo, 116 especificações em 8 grupos
          }
          // ... os restantes campos de extra_prep estão descritos abaixo
        }
      }
    },
    // ... e os restantes registos, 20 por página
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Campos do registo

• equipment - equipamento organizado por grupos; os grupos estão listados abaixo. O objeto só traz os itens que a versão tem. Como ler os valores:
  • ● - o item faz parte do equipamento de série da versão
  • ○ - pode ser encomendado à parte; o montante ao lado é o custo adicional em yuans, por exemplo "○ 6000 CNY"
  • texto ou número - a variante concreta, por exemplo "Genuine leather" ou "5G". A vírgula separa variantes, e o símbolo ○ refere-se à variante que o antecede: em "Heating, Ventilation, Massage ○", a massagem é encomendada à parte
  • traço - em "front ● / rear -", o equipamento existe à frente e não existe atrás; fora de um par destes, o traço não aparece
  • Uma cadeia vazia no lugar do objeto significa que o equipamento da versão é desconhecido
• images - cadeia com um array JSON dentro: ligação para a foto da versão; sem foto, a cadeia fica vazia
• images_360 - vista a 360 graus da carroçaria. Em frames vêm 30 ou 36 imagens para mostrar o carro a toda a volta. Os conjuntos distinguem-se pela cor da pintura, definida por color e color_hex; numa carroçaria bicolor, cada um destes valores traz as duas cores separadas por uma barra, com a cor principal primeiro. O inner_id do conjunto mostra que versão está nas imagens: se a própria não foi fotografada, usa-se outra do mesmo modelo. Se nenhuma versão do modelo foi fotografada, o array fica vazio
• images_gallery - fotos por categoria: cada conjunto tem category, inner_id e images, no máximo 20 fotos. Categorias: exterior aspeto exterior, interior tablier e volante, space bancos e habitáculo, details pormenores, official fotos oficiais do fabricante, features particularidades do modelo, auto_show imagens de salões automóveis, night fotos noturnas. A galeria está preenchida na maior parte do catálogo
• panorama_interior - panorâmica do interior. Um ponto de vista é composto por seis imagens: front, back, left, right, up, down, que juntas formam uma panorâmica cúbica. Os pontos de captação estão identificados por chaves: front condutor, passenger passageiro da frente, rear segunda fila, rear_welfare segunda fila com banco para passageiro com mobilidade reduzida, third terceira fila, trunk bagageira; só vêm os que foram fotografados. Os conjuntos estão agrupados por cor do interior, cada um com inner_id, color e color_hex. A panorâmica está preenchida em cerca de um quarto dos registos; nos restantes, o array fica vazio

Dentro de extra_prep

Em vez de ficheiros, chegam ligações para os servidores do Autohome.

Que grupos chegam

• 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 do primeiro evento na data indicada ou posterior. A data conta-se pela hora da China. Enquanto não houver eventos nessa data, a resposta é 0.

Parâmetros:

• date (obrigatório) - data no formato yyyy-mm-dd

Resposta:

{ "change_id": 81984 }

Comece a ler o feed com o ID recebido: passe-o em change_id do método /changes. Zero significa que ainda não há eventos; peça o ID mais tarde.

GET/changes

Feed de eventos: nova versão (added), novo valor de preço ou de estado de venda (changed), saída do catálogo do Autohome (removed).

Parâmetros:

• change_id (obrigatório) - a partir de qual ID de alteração

Resposta:

{
  "result": [
    {
      "id": 81984,
      "inner_id": "73940",
      "change_type": "added",
      "created_at": "2026-10-03T08:14:22.317+03:00",
      "data": { ... }  // o registo completo, como na resposta de /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" }  // depois da alteração: valor de price, preço do fabricante e estado de venda
    },
    {
      "id": 81986,
      "inner_id": "47831",
      "change_type": "removed",
      "created_at": "2026-10-03T08:17:41.205+03:00",
      "data": {}  // exemplo fictício: a versão desapareceu do catálogo do Autohome
    }
  ],
  "meta": {
    "cur_change_id": 81984,
    "next_change_id": 81987,
    "limit": 20
  }
}

No pedido seguinte, passe next_change_id. Se for null, ainda não há eventos novos: repita o mesmo pedido mais tarde. Os eventos das versões em arquivo também entram no feed.