Get vehicle details

GET

https://api.xapichina.com

cars

{car_id}

Get car details

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

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

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

{
  "id": "<string>",
  "title": "<string>",
  "source_url": "<string>",
  "manufacturer": "<string>",
  "model": "<string>",
  "model_year": 123,
  "registration_date": "<string>",
  "mileage_km": 123,
  "price_cny": 123,
  "price_eur": 123,
  "original_price_cny": 123,
  "location": "<string>",
  "district": "<string>",
  "color": "<string>",
  "fuel_type": "<string>",
  "transmission": "<string>",
  "engine": "<string>",
  "displacement_liters": 123,
  "drive_type": "<string>",
  "body_style": "<string>",
  "emissions_standard": "<string>",
  "seat_count": 123,
  "transfer_count": 123,
  "usage_type": "<string>",
  "annual_inspection_until": "<string>",
  "compulsory_insurance_until": "<string>",
  "fuel_consumption_l_100km": 123,
  "description": "<string>",
  "thumbnail": "<string>",
  "photos": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "published": "<string>",
  "follow_count": 123,
  "inspection_available": false,
  "insurance_available": false,
  "che168": {
    "catalog": {},
    "specification": {},
    "vehicle_identity": {},
    "location": {},
    "registration": {},
    "electric_vehicle": {},
    "warranty": {},
    "finance": {},
    "consumption": {},
    "seller": {},
    "media": {},
    "report_services": {},
    "listing": {}
  }
}

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

Behavior

Use a numeric listing ID returned by search. The response represents id as a string. Missing source fields can be null; missing native keys are omitted. Details already include photos, so a separate gallery call may be unnecessary. This call consumes one 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/cars/59967821?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.

{
  "id": "59967821",
  "title": "BMW 3 Series 2022 325Li",
  "manufacturer": "BMW",
  "model": "3 Series",
  "model_year": 2022,
  "mileage_km": 32000,
  "price_cny": 188000,
  "price_eur": 24102.56,
  "photos": [
    "https://example.com/listing-photo.jpg"
  ],
  "che168": {
    "catalog": {
      "brandname": "宝马",
      "seriesname": "宝马3系"
    },
    "electric_vehicle": null
  },
  "source_url": "https://www.che168.com/dealer/0/59967821.html"
}

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

Path Parameters

car_id

integer

required

Query Parameters

lang

enum<string>

default:en

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

Available options:

en,

zh

Response

Successful Response

string

required

title

string

required

source_url

string

required

manufacturer

string | null

model

string | null

model_year

integer | null

registration_date

string | null

mileage_km

integer | null

price_cny

integer | null

price_eur

number | null

CNY price converted to EUR, rounded to cents; null if price or exchange rate is unavailable

original_price_cny

integer | null

location

string | null

district

string | null

color

string | null

fuel_type

string | null

transmission

string | null

engine

string | null

displacement_liters

number | null

drive_type

string | null

body_style

string | null

emissions_standard

string | null

seat_count

integer | null

transfer_count

integer | null

usage_type

string | null

annual_inspection_until

string | null

compulsory_insurance_until

string | null

fuel_consumption_l_100km

number | null

description

string | null

thumbnail

string | null

photos

string[]

tags

string[]

published

string | null

follow_count

integer | null

inspection_available

boolean

default:false

An inspection or vehicle-condition report is advertised; use /inspection for supported findings and parsing status

insurance_available

boolean

default:false

Insurance claim-history data is available through this API; currently false because the public provider payload does not expose it

che168

Che168ListingData · object | null

Provider-native vehicle fields. Original names, values, units, and Chinese text are preserved in both languages; missing keys are omitted

Show child attributes

⌘I

Get car details

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

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

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

{
  "id": "<string>",
  "title": "<string>",
  "source_url": "<string>",
  "manufacturer": "<string>",
  "model": "<string>",
  "model_year": 123,
  "registration_date": "<string>",
  "mileage_km": 123,
  "price_cny": 123,
  "price_eur": 123,
  "original_price_cny": 123,
  "location": "<string>",
  "district": "<string>",
  "color": "<string>",
  "fuel_type": "<string>",
  "transmission": "<string>",
  "engine": "<string>",
  "displacement_liters": 123,
  "drive_type": "<string>",
  "body_style": "<string>",
  "emissions_standard": "<string>",
  "seat_count": 123,
  "transfer_count": 123,
  "usage_type": "<string>",
  "annual_inspection_until": "<string>",
  "compulsory_insurance_until": "<string>",
  "fuel_consumption_l_100km": 123,
  "description": "<string>",
  "thumbnail": "<string>",
  "photos": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "published": "<string>",
  "follow_count": 123,
  "inspection_available": false,
  "insurance_available": false,
  "che168": {
    "catalog": {},
    "specification": {},
    "vehicle_identity": {},
    "location": {},
    "registration": {},
    "electric_vehicle": {},
    "warranty": {},
    "finance": {},
    "consumption": {},
    "seller": {},
    "media": {},
    "report_services": {},
    "listing": {}
  }
}

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

Search

Catalog

Vehicles

Reports

Account

Behavior

Request example

Illustrative response

Authorizations

Path Parameters

Query Parameters

Response

​Behavior

​Request example

​Illustrative response

Authorizations

Path Parameters

Query Parameters

Response

Behavior

Request example

Illustrative response