Discover filter values

GET

https://api.xapichina.com

filters

Get available search filter values

curl --request GET \
  --url https://api.xapichina.com/v1/filters

{
  "manufacturers": [
    "<string>"
  ],
  "fuel_types": [
    "<string>"
  ],
  "transmissions": [
    "<string>"
  ],
  "body_styles": [
    "<string>"
  ],
  "sort_options": [
    "<string>"
  ]
}

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

Behavior

This endpoint is public and does not consume data quota. Use its values when constructing filter controls. lang affects supported manufacturer labels; filter enum values remain the values accepted by search. Authentication: Public; no API key required. Quota: Does not consume data quota.

Request example

curl --fail-with-body "https://api.xapichina.com/v1/filters?lang=en"

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.

{
  "manufacturers": [
    "BMW",
    "BYD"
  ],
  "fuel_types": [
    "gasoline",
    "diesel",
    "hybrid",
    "new_energy"
  ],
  "transmissions": [
    "manual",
    "automatic"
  ],
  "body_styles": [
    "compact",
    "suv"
  ],
  "sort_options": [
    "default",
    "price_asc",
    "price_desc",
    "newest",
    "youngest",
    "mileage_asc"
  ]
}

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

Query Parameters

lang

enum<string>

default:en

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

Available options:

en,

zh

Response

Successful Response

manufacturers

string[]

required

fuel_types

string[]

transmissions

string[]

body_styles

string[]

sort_options

string[]

⌘I

Get available search filter values

curl --request GET \
  --url https://api.xapichina.com/v1/filters

{
  "manufacturers": [
    "<string>"
  ],
  "fuel_types": [
    "<string>"
  ],
  "transmissions": [
    "<string>"
  ],
  "body_styles": [
    "<string>"
  ],
  "sort_options": [
    "<string>"
  ]
}

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

Search

Catalog

Vehicles

Reports

Account

Discover filter values

Behavior

Request example

Illustrative response

Query Parameters

Response

​Behavior

​Request example

​Illustrative response

Query Parameters

Response

Behavior

Request example

Illustrative response