What is Che168 API and how does it work?

Connect to China's largest car marketplace through our API. Fetch ready-to-use car data via REST calls. Track new listings, price changes, and removed vehicles.

What Che168 data does the parser extract?

All vehicle details: make, model, year, price, mileage, engine, transmission, VIN, inspection reports, service history, seller information, photos, and vehicle condition.

How often is Che168 data updated?

Real-time data synchronization. New car listings detected within minutes. Daily files with all active and removed vehicles.

What formats does Che168 API support?

Multiple formats: REST API for real-time data, JSON for formatted data, CSV for analysis, and Excel for reports. All formats provide complete car information.

Can I get VIN numbers through the API?

Yes, VIN codes are available for most Che168 listings. They are included in the detailed vehicle card through the /offer endpoint.

How often are daily exports updated?

New files are generated every morning. They contain a complete snapshot of active listings and a list of vehicles removed the previous day.

Which regions of China are covered?

Che168 covers all provinces of China. Data includes seller location and allows filtering by cities and regions.

Che168 APIScraper & Parser

Access vehicle data from China auto platform. VIN numbers, inspection reports, service history. Real-time monitoring of listing updates.

Che168 API

Get Chinese car data directly via API. Direct access to vehicle information without building scrapers. Ideal for market research, price analysis, and business intelligence.

API

Get alerts when new cars appear on Che168. Track listings the moment they go live.

Daily Exports

Daily files with all current listings and pricing data.

Complete Data

Get formatted data through the API: Price, Mileage, Year, Make, Model, Technical Specs, Inspection Reports, Service History, and Vehicle Condition.

Get API AccessAccess provided within 2 minutes

API

Base URL

https://{access_name}.auto-api.com/api/v2/che168

Authorization: api_key parameter

Workflow

/filtersquery all available filter options

/offersget car listings with pagination and filtering - recommended for bulk data import

For keeping your data current after the initial import:

/change_id?date=...get the initial ID to begin tracking changes

/changes?change_id=...fetch all updates since a specified change ID

/offerretrieve full details of a single listing using inner_id

Suggested integration workflow:

1. Begin with /offers to download the complete dataset (iterate through all pages)

2. Then poll /changes at regular intervals to capture all updates (additions/changes/removals) and synchronize your database

3. To display data on your site, use /offers with filters and pagination parameters (make, model, price, year, and more)

GET/filters

Provides all filterable fields and their valid values

https://{access_name}.auto-api.com/api/v2/che168/filters?api_key=YOUR_API_KEY

Response:

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

Paginated list of vehicle listings with filter support

Parameters:

page (required) - page number
mark, model, transmission_type, color, body_type, engine_type - filters (case-insensitive)
year_from, year_to - year range filter
km_age_from, km_age_to - mileage range filter
price_from, price_to - price range filter (in CNY)

https://{access_name}.auto-api.com/api/v2/che168/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/che168/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&color=black

Response:

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

Data fields:

id - internal database ID
inner_id - listing ID on the platform
url - link to the listing
mark - car brand
model - car model
year - production year
color - color
price - price in CNY
km_age - mileage in km
engine_type - engine type
drive_type - drive type

transmission_type - transmission type
body_type - body type
address - address
seller_type - seller type
is_dealer - dealer flag (true/false)
section - section
salon_id - dealer ID
displacement - engine displacement
images - array of image URLs
power - power in hp

GET/change_id

Get starting change ID for a given date (required for /changes endpoint)

Parameters:

date (required) - date in yyyy-mm-dd format

https://{access_name}.auto-api.com/api/v2/che168/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Response:

{ "change_id": 3294715 }

Use the returned value as the change_id parameter in /changes

GET/changes

Incremental updates feed (added/changed/removed records)

Parameters:

change_id (required) - starting from which change ID

https://{access_name}.auto-api.com/api/v2/che168/changes?api_key=YOUR_API_KEY&change_id=1

Response:

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

GET/offer

Detailed information for a specific listing by inner_id

Parameters:

inner_id (required)

https://{access_name}.auto-api.com/api/v2/che168/offer?api_key=YOUR_API_KEY&inner_id=55651236

Response: single data object (same fields as /offers items, returned directly without result wrapper)

Get Listing by URL

Retrieve complete listing data by providing the che168.com URL

Base URL

https://{access_name}.auto-api.com/api/v1/offer/info

Authorization: header x-api-key

POST/api/v1/offer/info

Get listing data from che168.com by URL

Parameters:

url (required) - link to the listing on che168.com

Request Example:

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" }'

Response:

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

Field Descriptions:

inner_id - listing ID on che168.com
url - link to the listing
mark - car brand
model - car model
year - production year
color - vehicle color
price - price in CNY
km_age - mileage in kilometers

engine_type - engine/fuel type
transmission_type - transmission type
body_type - body type
drive_type - drive type (FWD, RWD, AWD)
displacement - engine displacement
vin - vehicle identification number
city - seller city
seller_type - seller type
is_dealer - dealer flag
offer_created - listing creation date
images - array of image URLs
power - engine power in horsepower (hp)
first_registration - first registration date (YYYY-MM)

Daily Exports

File Storage

Files stored for 3 days minimum

Update Schedule

Fresh data files generated daily and available for download

File Format

CSV files use pipe symbol (|) to separate columns

URL Structure:

https://{access_name}.auto-api.com/{date}/{file_name}

Request Parameters:

access_name - access_name - your assigned subdomain identifier
date - date - target date in yyyy-mm-dd format (e.g., 2025-09-06)
file_name - file_name - export file name with extension

Available Formats:

CSV - all_active.csv, new_daily.csv, removed_daily.csv
JSON - all_active.json, new_daily.json, removed_daily.json
Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

cURL API Request Example

curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

Wget Download Command

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'

Che168.com

Che168.com listings feature full vehicle data including specifications, pricing, seller information, and location details. This data reveals market trends, pricing patterns, and buyer behavior across China's automotive market.

Vehicle histories, inspection reports, and financing data from the platform provide valuable insights. Companies use this data for inventory planning, pricing decisions, and market strategy.

Market research teams, automotive app developers, and analysts use this data through our Che168 API. Direct data access means no scraper development or maintenance work.

Che168 API runs continuously, detecting new listings within minutes and monitoring price changes for real-time market data. All automotive information is available through structured API endpoints.

Other Automotive Data

Expand your automotive data coverage across global markets with our platform APIs:

🇦🇪

Dubizzle API

UAE automotive data API

🇪🇺

AutoScout24 API

Europe automotive data API

🇩🇪

Mobile.de API

Germany automotive data API

🇦🇪