Developer reference

Build with XAPI China

Search Che168 listings and retrieve structured specifications, photo URLs, and available inspection data. Authenticate with the X-API-Key header. English responses are enabled by default.

1. Create an API key

2. Search listings

Call /v1/search with brand, model, age, mileage, price, fuel, transmission, body style, sort, and page filters. Use currency=eur for EUR budget bounds.

3. Retrieve the details

Use /v1/cars/{car_id} for specifications and native source data, /images for photos, and /inspection for available report findings. Add view=full for component rows.

GET/v1/search?brand=BMW

curl "https://api.xapichina.com/v1/search?brand=BMW&lang=en" \
  -H "X-API-Key: xcn_YOUR_KEY"

Example responseapplication/json

{
  "total_count": 1,
  "page": 1,
  "limit": 24,
  "results": [
    {
      "id": "59967821",
      "title": "BMW 3 Series 2022 325Li",
      "year": 2022,
      "mileage_km": 32000,
      "price_cny": 188000,
      "price_eur": 24102.56,
      "location": "Shanghai",
      "source_url": "https://www.che168.com/dealer/0/59967821.html"
    }
  ],
  "next_page": null
}

Illustrative data. Actual results and exchange rates vary. Keep secret API keys on your server.

Source coverage matters

Supported labels are translated; unknown text remains in Chinese. EUR bounds round inward to ¥10,000 steps. Inspection availability and extraction coverage are explicit. Structured insurance claims are currently unavailable.

Loading the API reference…