Search listings

GET

https://api.xapichina.com

Search Che168 used-car listings

curl --request GET \
  --url https://api.xapichina.com/v1/search \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.xapichina.com/v1/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "total_count": 123,
  "page": 123,
  "limit": 123,
  "results": [
    {
      "id": "<string>",
      "title": "<string>",
      "source_url": "<string>",
      "year": 123,
      "mileage_km": 123,
      "price_cny": 123,
      "price_eur": 123,
      "location": "<string>",
      "thumbnail": "<string>"
    }
  ],
  "next_page": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Behavior

Search returns up to 24 listings per upstream page. Follow next_page until it is null; there is no caller-selected search limit. Use vehicle age filters rather than year_from / year_to. Each successful page consumes one account-wide data request. Authentication: Secret API key in X-API-Key. Quota: One successful call consumes one data request.

Request example

curl --fail-with-body "https://api.xapichina.com/v1/search?brand=BMW&page=1&lang=en" \
  -H "X-API-Key: $XAPICHINA_API_KEY"

Illustrative response

The following example is abbreviated. It demonstrates the response shape rather than live inventory or guaranteed field coverage. The generated schema describes the complete contract.

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

Read the integration guide for parameter rules, source interpretation, and error handling. Use the generated request playground with your own server-side API key.

Authorizations

X-API-Key

string

header

required

Query Parameters

page

integer

default:1

Required range: 1 <= x <= 1000

lang

enum<string>

default:en

Response language: en (English) or zh (Chinese)

Available options:

en,

zh

string | null

Raw Che168 keyword

Maximum string length: 100

brand

string | null

Chinese or English make name, ID, or pinyin

Maximum string length: 100

model

string | null

Chinese or supported English model name/keyword

Maximum string length: 100

price_min

integer | null

Minimum price in currency; CNY must be a multiple of 10,000; EUR rounds up to a 10,000-CNY step

Required range: x >= 0

price_max

integer | null

Maximum price in currency; CNY must be a multiple of 10,000; EUR rounds down to a 10,000-CNY step

Required range: x >= 0

currency

enum<string>

default:cny

Currency of price_min/price_max. EUR bounds round inward to Che168's 10,000-CNY steps and may exclude cars near the edges.

Available options:

cny,

eur

age_min

integer | null

Minimum vehicle age in years

Required range: 0 <= x <= 100

age_max

integer | null

Maximum vehicle age in years

Required range: 0 <= x <= 100

mileage_min

integer | null

Minimum km; must be a multiple of 10,000

Required range: x >= 0

mileage_max

integer | null

Maximum km; must be a multiple of 10,000

Required range: x >= 0

fuel_type

string | null

Comma-separated: gasoline, diesel, hybrid, new_energy

transmission

enum<string> | null

Available options:

manual,

automatic

body_style

string | null

One value returned by /v1/filters

sort

enum<string>

default:default

Available options:

default,

price_asc,

price_desc,

newest,

youngest,

mileage_asc

Response

Successful Response

total_count

integer

required

page

integer

required

limit

integer

required

results

CarListing · object[]

required

Show child attributes

next_page

integer | null

⌘I

Search Che168 used-car listings

curl --request GET \
  --url https://api.xapichina.com/v1/search \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.xapichina.com/v1/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "total_count": 123,
  "page": 123,
  "limit": 123,
  "results": [
    {
      "id": "<string>",
      "title": "<string>",
      "source_url": "<string>",
      "year": 123,
      "mileage_km": 123,
      "price_cny": 123,
      "price_eur": 123,
      "location": "<string>",
      "thumbnail": "<string>"
    }
  ],
  "next_page": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Search

Catalog

Vehicles

Reports

Account

Behavior

Request example

Illustrative response

Authorizations

Query Parameters

Response

​Behavior

​Request example

​Illustrative response

Authorizations

Query Parameters

Response

Behavior

Request example

Illustrative response