二手车信息查询接口（usedcar.list）：按省 / 市分页拉取车源

这个接口能解决什么问题

做车源同步、行情分析或展示类应用时，usedcar.list 是拉取成批车源最省事的接口：只需要一个必填参数「省份 adCode」（城市可选，不传查全省），一次请求返回一页车源，字段精简到可直接入库或渲染列表页。如需对某辆车做价格判断，请配合使用 usedcar.price（二手车价格评估）。

一句话说明

只传省份 adCode 即可拉取全省车源；单页最多 20 条，无车源不收费。

适用场景

车源同步：把车源批量拉回本地库
行情分析：按地区统计在售车源与价格
选品与展示：展厅小程序 / H5 展示车源列表
与 usedcar.price 配合做单辆车估值

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/usedcar/list`
请求方式	GET（province / city / page / pageSize 放 Query；只有 province 必填）
鉴权方式	请求头 `X-API-Key`
接口编码	`usedcar.list`
收费类型	按次计费（PER_CALL，0.0100 元/次）
计费规则	查得计费：上游不可用或一条车源都没有时失败且不扣费
分页	单页 1 ~ 20 条（默认 20），page 默认 1
典型用途	车源同步、行情分析、选品展示

如何调用

cURL

# 只传省份：按该省全省拉取
curl -s -G "https://api.xujian.tech/openapi/usedcar/list" --data-urlencode "province=500000" -H "X-API-Key: 你的APIKey"

# 指定城市 + 分页
curl -s -G "https://api.xujian.tech/openapi/usedcar/list" --data-urlencode "province=500000" --data-urlencode "city=500100" --data-urlencode "page=1" --data-urlencode "pageSize=20" -H "X-API-Key: 你的APIKey"

单位与取值约定

注意单位

mileage（行驶里程）单位是万公里；price（车辆售价）与 downPayment（首付）单位是万元；regDate（注册年份）形如「2024年」。province / city 是 6 位行政区划代码（如重庆 500000 / 500100）。

返回示例（code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 138,
    "page": 1,
    "pageSize": 20,
    "list": [
      {
        "title": "2022年 大众 迈腾 330TSI",
        "image": "https://xxx/car.jpg",
        "mileage": "3.2",
        "price": "11.8",
        "downPayment": "2.36",
        "regDate": "2022年",
        "tags": "准新车,0次过户"
      }
    ],
    "apiCode": "usedcar.list",
    "apiName": "二手车信息查询",
    "chargeType": "PER_CALL",
    "balance": 99.9900,
    "costMs": 320
  }
}

计费说明

按次计费，0.0100 元/次。采用「先预鉴权、查到车源后扣费」两段式；上游不可用或一条车源都没有时返回失败，不扣费。翻页时每翻一页计一次费用，建议本地缓存已拉取的车源。

常见问题

province 怎么填？ 是 6 位行政区划代码（adcode），不是名称；可用 region.query 查。
价格和里程单位？ 售价是万元、里程是万公里，渲染前务必带上单位。
单页最多多少条？ 20 条；pageSize 超过 20 按 20 返回。