> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xapichina.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Search Chinese used-car listings and retrieve structured vehicle data with XAPI China.

# XAPI China API

XAPI China provides a REST API for publicly available Che168 used-car listings, with structured specifications, photos, CNY and EUR prices, supported translations, and available inspection findings.

<Note>
  XAPI China is an independent service and is not affiliated with or endorsed by Che168.
</Note>

<CardGroup cols={3}>
  <Card title="Get an API key" icon="key-round" href="/authentication">
    Create a free account and send your secret key in the X-API-Key header.
  </Card>

  <Card title="Search inventory" icon="search" href="/pagination-and-filters">
    Filter by brand, model, age, mileage, fuel, transmission, body style, and price.
  </Card>

  <Card title="Explore a vehicle" icon="car-front" href="/vehicle-details">
    Load specifications, photo galleries, similar listings, and available reports.
  </Card>
</CardGroup>

## Base URL

```text theme={"system"}
https://api.xapichina.com
```

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

## A typical integration

1. [Create a key and make your first request](/quickstart).
2. Discover supported [manufacturers and models](/makes-and-models).
3. [Search and paginate](/pagination-and-filters) through matching listings.
4. Use a listing ID to load [details and photos](/vehicle-details).
5. Check the coverage of [inspection and insurance-event evidence](/inspection-and-insurance).
6. Add timeouts, caching, and quota handling using the [production guide](/production-guide).

The **API Reference** tab contains all 11 public endpoints, current parameter schemas, response models, an interactive request playground, and endpoint-specific usage notes. Start with the [endpoint map](/api-overview) to understand authentication and quota behavior.

## Build with Chinese vehicle data

<CardGroup cols={3}>
  <Card title="Prices and budgets" icon="coins" href="/currencies-and-prices">Understand CNY/EUR conversion and source filter steps.</Card>
  <Card title="English and Chinese" icon="languages" href="/translations">Choose display language and preserve original values.</Card>
  <Card title="EV specifications" icon="battery-charging" href="/electric-vehicles">Read native battery, charging, range, and warranty fields.</Card>
  <Card title="Report coverage" icon="file-search" href="/inspection-providers">Interpret provider grades, categories, and partial findings.</Card>
  <Card title="Python examples" icon="code" href="/python-integration">Use requests with timeouts, pagination, and bounded retries.</Card>
  <Card title="JavaScript examples" icon="braces" href="/javascript-integration">Build a server-side fetch integration.</Card>
</CardGroup>

Use [plans and billing](/plans-and-billing) to understand shared account allowances and [errors and limits](/errors-and-limits) for status-code handling.

## What differs from Korean listing data

* Prices are returned in CNY and, when an exchange rate is available, EUR.
* Search uses vehicle age rather than Korea's `year_from` / `year_to` filters.
* English is the default. `lang=zh` returns Chinese display fields, and native Che168 fields retain source values in either language.
* Inspection findings preserve provider-specific categories and grades. Structured insurance claim records are currently unavailable.

See [data fields](/data-fields) for units and missing values. Inventory depends on the upstream marketplace and can be cached; recheck important listing information before acting on it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.