Used Cars API - Encar, Che168, Copart, IAAI

Used-car listings from Encar (Korea), Che168 (China), Copart and IAAI (USA) in one normalized JSON: search, change feed, references

原始信息汇总

Used Cars API - Encar, Che168, Copart, IAAI

基本信息

项目	内容
详情页地址	https://rapidapi.com/АрутНазарян/api/used-cars-api-encar-che168-copart-iaai2
API 版本	1.0.0（current）
类别	Transportation
API 创建者	Apiauto Space
订阅者	0
资源	Product Website、Terms of Use
订阅计划	BASIC：$0.00；PRO：$79.00；ULTRA：$149.00；MEGA：$349.00
官网	https://apiauto.space/en/
免责声明	与 Encar、Che168（Autohome）、Copart 或 IAAI 无关联

数据集概述

• 只读 REST API，聚合 Encar（韩国）、Che168（中国）、Copart 和 IAAI 拍卖（美国）的二手车列表，统一为规范化 JSON 记录。
• 数据量约 450,000 辆：Encar 约 140,000 辆；Che168 约 234,000 辆；Copart 和 IAAI 即将拍卖批次约 80,000 辆（2026 年 10 月）。
• 各市场副本按每小时目标刷新，每个响应通过 X-Data-Age-Seconds 头报告数据年龄。
• 支持搜索、按 ID 获取车辆、变更 feed 和参考数据。

市场

market	来源	内容
kr	Encar	韩国约 140,000 辆二手车
cn	Che168（Autohome）	中国约 234,000 辆二手车
us	Copart、IAAI	美国约 80,000 个即将拍卖批次

数据格式

• 所有市场使用一种记录格式。
• 品牌和型号统一为拉丁字母；中文和韩文名称会映射。
• price 为本地货币（KRW、CNY 或 USD）；price_usd 按 ECB 每日汇率折算。
• 里程统一为公里。
• vin 在来源提供时填充：美国批次有，韩国车辆很少，中国车辆没有。
• 照片以记录中的链接形式提供。
• 来源特有字段保存在 raw：Encar 检测标记，Copart 和 IAAI 损坏、title 文件、销售日期、出价、英里制里程表等。
• 示例记录字段包括：id、market、title、brand、model、generation、year、mileage_km、fuel、price、price_usd、photo_count、listing_url、is_active。

端点

• cars：GET Search cars；GET Get car by id
• changes：变更 feed
• references：参考数据

具体路径：

• GET /v1/cars
• GET /v1/cars/{car_id}
• GET /v1/changes
• GET /v1/references/markets
• GET /v1/references/brands
• GET /v1/references/models
• GET /v1/references/dictionaries

快速开始

1. GET /v1/references/markets
2. GET /v1/references/brands?market=kr
3. GET /v1/references/models?market=kr&brand=Kia
4. GET /v1/cars?market=kr&brand=Kia&model=Sorento&year_min=2021&limit=20

调用示例使用 X-RapidAPI-Key 和 X-RapidAPI-Host 请求头。

搜索过滤器

GET /v1/cars 需要 market，可选过滤器：

• brand、model、generation、trim：忽略大小写、空格和连字符。
• year_min、year_max
• price_min、price_max（本地货币）
• price_usd_min、price_usd_max（美元）
• mileage_max（公里）
• fuel、transmission、body_type：值来自 GET /v1/references/dictionaries
• has_photos、is_active（false 返回最近 14 天下架的车辆）
• q：标题最多 6 个词
• sort：-first_seen（默认，最新优先）、first_seen、price、-price、year、-year、mileage、-mileage
• limit：每页车辆数，最多 100

提示：按价格排序时可添加 price_usd_min=1000；部分韩国列表显示月租付款而非全价。

分页

• 仅支持游标分页。
• 每页返回 next_cursor；将其作为 cursor 传入以获取下一页。
• next_cursor 为 null 时表示已到末尾。
• 不支持 offset。

变更 Feed

GET /v1/changes?market=cn&since=2026-10-01T00:00:00Z 返回指定时间后的变化。

type	含义
added	新车辆出现
disappeared	车辆下架或售出
price_drop	价格下降（old_price、new_price、pct）
price_up	价格上升

可按 type（可重复）和 min_pct 过滤，再通过 GET /v1/cars/{car_id} 读取车辆。

错误

• 错误为 JSON：{"error": "code", ...}。
• 400：参数错误。
• 404：无此 ID 的车辆。
• 429：每秒请求过多，按 retry_after 秒后重试。
• 如关注新鲜度，检查 X-Data-Age-Seconds。

开源客户端与示例

• Python：pip install apiauto-space
• JavaScript / TypeScript：npm i apiauto
• 示例语言：curl、Python、JavaScript、PHP
• 代码仓库：https://github.com/apiauto-space
• 示例仓库：https://github.com/apiauto-space/encar-api-examples