CHE168 API

CHE168 API: listings and catalog for cars from China

The same contract as the Encar API — only providerId changes. MotorFeed reads CHE168, maps it to the shared schema, converts the price out of yuan, and returns ready-to-use JSON for a website, a CRM, or an internal dashboard.

Try the API Message us on Telegram

catalog levels: brand, series, modification

API contract for both sources — providerId=2 selects CHE168

pricing markets: MD, RU, UA, and AE

quota spent on catalog reference endpoints

vehicle page

JSON

GET /vehicles/che168_58234901
  ?country=UA&currency=USD

{
  "title": "Li Auto L7 Pro, 2023",
  "vehicleIdentity": {
    "brand": "Li Auto",
    "model": "L7",
    "generation": "2023",
    "modification": "Pro"
  },
  "vehicleId": 58234901,
  "vin": "LRW1234567890****",
  "spec": {
    "firstRegistrationDate": "2023-04",
    "mileageKm": 24000,
    "displacementLiters": 1.5,
    "fuelType": "增程式",
    "transmission": "电动车单速变速箱",
    "driveType": "四驱",
    "color": "白色"
  },
  "advertisement": {
    "sourceCurrency": "CNY",
    "sourcePriceWan": 25.8,
    "sourcePrice": 258000,
    "region": "上海"
  },
  "condition": {
    "transferCount": 1,
    "inspectionExpiresAt": "2026-04",
    "certification": 1
  },
  "pricing": {
    "country": "UA",
    "currency": "USD",
    "sourcePrice": 35600,
    "fees": [
      { "code": "logistics", "amount": 3800 },
      { "code": "customs_duty", "amount": 3560 },
      { "code": "excise_tax", "amount": 1250 },
      { "code": "vat", "amount": 8842 }
    ],
    "total": 53052,
    "ratesUsed": { "CNY": 7.24, "UAH": 41.8 },
    "estimated": false
  }
}

What the API returns

What you get out of CHE168

The Chinese market is served by the same methods as the Korean one: the same fields, the same sort keys, the same error format.

Catalog

Brands, series, and modifications

A cascade of reference endpoints for filters: brand, series, and modifications grouped by model year. Responses are cached and never spend your request package.

Chinese listings in your results

POST /search with providerId=2 accepts brand, series, modification, price, year, and mileage. Sort keys are the ones you already use for Encar: newest, priceAsc, mileageAsc, and the rest.

Vehicle

Everything about one car

An id such as che168_58234901 returns specs, the VIN when published, photos, listing tags, the dealer, the region, and the seller description.

One model

Shared catalog with Encar

Brand, model, generation, and modification resolve into the same MotorFeed catalog, so Korean and Chinese cars land in one set of storefront filters.

Price

Converted out of yuan

The listing price arrives in the source 万 format, in yuan, and converted into the customer's currency using your rates or the server's.

Condition

Ownership record

Number of ownership transfers, inspection and insurance expiry dates, the seller certification flag, and a link to the seller report when one is published.

Catalog

Brands, series, generations, and vehicles

The cascade works the way it does for Encar, but follows the structure of the Chinese source: brand, series, then the modifications inside a model year.

Brands

The full list of Chinese-market brands, both domestic and localized global ones.

GET /catalog/manufacturers?providerId=2

Series

Series inside a brand — what a visitor reads as the model.

GET /catalog/model-groups?providerId=2

Modifications by year

Modifications grouped by model year: the year becomes the generation, and the modification itself is the deepest filter level.

GET /catalog/models?providerId=2

Vehicles

Listings for the ids you collected: the items, the total count, and filter facets.

POST /search

CHE168 has no separate trim level: the source does not publish one as its own reference list, so /catalog/badges returns an empty list. The modification covers the filter depth, and the model year of the group becomes the generation in the shared data model.

catalog cascade and search

HTTP

GET /catalog/manufacturers?providerId=2
GET /catalog/model-groups
  ?providerId=2&manufacturerCd=33
GET /catalog/models
  ?providerId=2&manufacturerCd=33&modelGroupCd=3170

POST /search
{
  "providerId": 2,
  "country": "UA",
  "currency": "USD",
  "filters": {
    "brandId": "33",
    "modelId": "3170",
    "year": { "min": 2022 },
    "mileage": { "max": 60000 }
  },
  "sort": "priceAsc",
  "limit": 20
}

Images

Photos with ready-made links

The photo block has the same shape as Encar's, so the gallery code on your side stays the same for both sources.

thumbnailUrl

The thumbnail for lists and search results.

heroUrl

The frame for the vehicle page cover.

url

The gallery link.

Main photo

The first frame is typed as main; the rest arrive as the gallery in source order.

https only

Source links are normalized to https, so images never break the page with mixed content.

Nothing to store

There are no files to download and keep: the response already carries usable image addresses.

Specifications

What a vehicle response contains

The vehicle page for the Chinese source. The sections match Encar's; only the content differs, following what the source itself publishes.

Identity

A prefixed id such as che168_58234901
VIN when published
Brand, series, generation, and modification in one structure
Source ids: brandId, seriesId, specId, dealerId

Technical data

First registration date and year
Mileage in kilometers
Displacement in liters and the engine designation
Transmission, drivetrain, and aspiration
Fuel type, color, and emission class

Listing

Price in yuan and in the source 万 format
Conversion into the customer's currency using your rates
Region, city, and province
Publication date and follower count
Seller description and listing tags

Condition and pricing

Number of ownership transfers
Inspection and insurance expiry dates
Certification flag and the seller report link
Shipping, duty, excise, VAT, and fees line by line, with the total

Freshness

How the data is refreshed

Requests reach the source at call time while the heavy reference data stays in an index — results stay current without needless load.

Read at call time

Search and vehicle pages call CHE168 when you call them: price and availability are correct as of the response.

Catalog index

Brands, series, and modifications are kept in an index refreshed in the background, so filters answer fast.

Signed requests

The source requires signed requests; the service builds the signatures itself, so a change on their side is not a change on yours.

Detail backfill

When the result list is missing fields, the service pulls the listing detail so the list and the vehicle page never disagree.

Documentation

Swagger UI and OpenAPI

CHE168 lives in the same schema as Encar: there is no second documentation to learn, you only pass providerId=2.

Swagger UI at /docs: call the methods straight from the browser with your key.
The machine-readable schema at /docs-json — generate a client in your own language.
Errors are documented explicitly: 401 without a key, 402 without an active subscription, 403 from an untrusted IP, 429 over the rate limit.
Keys, trusted IPs, and request usage are visible in your account.

Pricing

Access to the CHE168 API

€149

per month, Start plan

Plans cover every source: one key opens both the Korean and the Chinese data. Paying yearly takes 15% off.

Start — up to 10,000 requests per month

Grow — up to 30,000 requests and priority support

Scale — up to 100,000 requests and up to 3 domains or IPs

Both sources come with one key, with no surcharge for the second

See all plans

Want cars from China in your catalog?

Create an account and get a key, or message us on Telegram — we will walk you through combining Korean and Chinese listings in a single storefront.

Try the API Message us on Telegram