Che168 APIScraper & Parser

GET/filters

Предоставя всички полета за филтриране и допустимите им стойности

Отговор:

{
  "mark": {
    "BMW": { "model": ["X5", "X3", "3 Series"] },
    "Audi": { "model": ["A4", "A6", "Q7"] }
  },
  "transmission_type": ["Manual", "Automatic"],
  "color": ["White", "Black", "Silver", "Dark Gray", "Blue", "Red", "Brown", "Orange", "Yellow", "Green", "Purple", "Champagne", "Other"],
  "body_type": ["Crossover/SUV", "Sedan", "Hatchback", "Minivan", "Pickup", "Coupe/Roadster", "Microvan", "Light Truck", "Van", "Mini"],
  "engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid", "Plug-in Hybrid", "Range Extender", "Hydrogen Fuel Cell", "Gasoline + 48V Mild Hybrid", "Gasoline + 24V Mild Hybrid", "Gasoline + CNG", "CNG"],
  "drive_type": ["FWD", "RWD", "AWD", "RWD (dual-motor)", "AWD (dual-motor)", "AWD (tri-motor)", "AWD (quad-motor)"]
}

GET/offers

Страниран списък с автомобилни обяви с поддръжка на филтри

Параметри:

• page (задължително) - номер на страницата
• mark, model, transmission_type, color, body_type, engine_type - филтри (без разлика между главни и малки букви)
• year_from, year_to - филтър по диапазон от години
• km_age_from, km_age_to - филтър по диапазон на пробега
• price_from, price_to - филтър по диапазон на цената (в CNY)

Отговор:

{
  "result": [
    {
      "id": 1273379,
      "inner_id": "55651236",
      "change_type": "added",
      "created_at": "2025-08-05T08:18:10.679Z",
      "data": {
        "id": 1273379,
        "inner_id": "55651236",
        "url": "https://www.che168.com/dealer/648815/55651236.html",
        "mark": "Lamborghini",
        "model": "Huracán",
        "title": "Huracán 2020 Huracán EVO RWD",
        "year": 2020,
        "color": "Red",
        "price": 1890000,
        "km_age": 19000,
        "engine_type": "Gasoline",
        "transmission_type": "Automatic",
        "body_type": "Sports Car",
        "drive_type": "RWD (mid-engine)",
        "address": "Shanghai, Minhang",
        "seller_type": "dealer",
        "is_dealer": true,
        "section": "Used",
        "salon_id": "648815",
        "description": "Shanghai Luxury Car Store: 166 detailed inspections...",
        "displacement": 5.2,
        "offer_created": "2025-08-05",
        "images": ["https://2sc2.autoimg.cn/escimg/auto/g34/M04/C4/EC/..."],
        "extra": {"inspection": {...}, "configuration": {...}},
        "power": 610
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Полета с данни:

GET/change_id

Получаване на началното ID на промяна за дадена дата (необходимо за крайната точка /changes)

Параметри:

• date (задължително) - дата във формат yyyy-mm-dd

Отговор:

{ "change_id": 3294715 }

Използвайте върнатата стойност като параметър change_id в /changes

GET/changes

Поток от инкрементални обновявания (добавени/променени/премахнати записи)

Параметри:

• change_id (задължително) - от кое ID на промяна да се започне

Отговор:

{
  "result": [
    {
      "id": 456,
      "inner_id": "55651236",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "55651237",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 1790000 }
    },
    {
      "id": 458,
      "inner_id": "55651238",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2025-01-15T10:32:00Z"
    }
  ],
  "meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}

POST/api/v1/offer/info

Получаване на данни от обява в che168.com по URL

Параметри:

• url (задължително) - link to the listing on che168.com

Примерна заявка:

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": "https://www.che168.com/dealer/413863/56520004.html" }'

Отговор:

{
  "inner_id": "56520004",
  "url": "https://www.che168.com/dealer/413863/56520004.html",
  "mark": "Ora",
  "model": "Black Cat",
  "year": 2020,
  "color": "White",
  "price": 31800,
  "km_age": 54000,
  "engine_type": "Electric",
  "transmission_type": "Automatic",
  "body_type": "Mini",
  "drive_type": "FWD",
  "displacement": "0",
  "vin": "LGWECMA47LE008164",
  "city": "Shenzhen",
  "seller_type": "dealer",
  "is_dealer": true,
  "offer_created": "2025-12-04",
  "images": [
    "https://2sc2.autoimg.cn/escimg/auto/g33/M0B/AE/D7/1024x768_c42_autohomecar__ChxpVWj8TteALlI3AAnIctts-w8397.jpg.webp",
    "https://2sc2.autoimg.cn/escimg/auto/g34/M0B/A3/C5/1024x768_c42_autohomecar__ChxpWGj8TtiAJ0EJAAq9t0PZjQc486.jpg.webp"
  ],
  "power": 61,
  "first_registration": "2020-09"
}

Описание на полетата: