AutoTrader

Real-time US automotive inventory, vehicle specs, high-res photos, dealer information, and KBB fair purchase price by VIN or ZIP code.

原始信息汇总

AutoTrader API 数据集概述

基本信息

• API 名称：AutoTrader
• 提供方：Crawlio
• 分类：Transportation（交通）
• 订阅人数：1
• 当前版本：v1

订阅计划

计划	价格
BASIC	$0.00 / mo
PRO	$12.00 / mo
ULTRA	$25.00 / mo

API 概述

提供实时美国汽车库存、车辆规格、高清照片、经销商信息，以及基于 VIN 或 ZIP code 的 KBB 公允购买价格。

核心亮点

• 全国实时库存：按 5 位 ZIP 码或城市名、半径、品牌、型号、年份、价格、里程搜索活跃车辆列表。
• 深度车辆规格：获取车窗贴纸功能、变速箱、发动机排量、驱动方式、外观/内饰颜色代码。
• Kelley Blue Book 估值：按 VIN 获取行业基准公允购买价格（FPP）、典型挂牌价格和市场范围。
• 经销商目录：获取经销商联系方式、库存指标、客户评分和实体店地址。
• 车辆历史洞察：查询干净产权指标、事故次数、车主历史和 CARFAX 报告链接。
• 顺序游标分页：标准 limit 和 offset 分页，带 nextOffset 指针和严格边界验证。

端点概览

端点	方法	分类	描述
/vehicles/search	GET	Vehicles	按位置、品牌、型号、价格、年份和车辆状况搜索库存。
/vehicles/details	GET	Vehicles	完整车辆档案、设备包、CARFAX 摘要和卖家评论。
/vehicles/similar	GET	Vehicles	获取匹配目标车辆配置和细分市场的可比列表。
/vehicles/pricing	GET	Valuation	按 VIN 获取 Kelley Blue Book 公允购买价格和市场范围。
/dealers/details	GET	Dealers	经销商联系方式、场地库存数量、评分和地址。
/reference/makes	GET	Reference	列出所有可用车辆品牌代码和显示名称。
/reference/models	GET	Reference	列出所选品牌可用的型号。
/reference/keywords	GET	Reference	获取自动完成搜索关键词建议。
/locations/lookup	GET	Reference	将美国邮政 ZIP 码解析为坐标和市场区域。
/health	GET	Meta	检查 API 健康状况和版本元数据。

常用查询参数

参数	类型	必填	描述
location	string	是（搜索时）	5 位美国 ZIP 码（如 90210）或主要城市名（如 Miami、Dallas）。
limit	integer	否	每页记录数（1 到 50，默认 20）。
offset	integer	否	顺序分页偏移量（从 0 开始）。第一页用 0，之后传 nextOffset。
sort	string	否	排序方式（relevance、derivedpriceASC、derivedpriceDESC、mileageASC、yearDESC、distanceASC）。

车辆库存搜索

端点：GET /vehicles/search

参数

参数	类型	必填	描述
location	string	是	5 位美国 ZIP 码或城市名（如 90210、Miami）。
radius	integer	否	搜索半径（英里）（如 25、50、100、250）。默认 50。
make	string	否	车辆品牌代码（如 TOYOTA、FORD、BMW、CHEV）。
model	string	否	车辆型号代码（如 CAMRY、F150PICKUP、3_SERIES）。
stock_type	string	否	库存状况：used、new 或 cpo。
price_min	integer	否	最低价格（USD）。
price_max	integer	否	最高价格（USD）。
year_min	integer	否	最早车型年份（如 2018）。
year_max	integer	否	最新车型年份（如 2025）。
mileage_max	integer	否	最大里程表读数。
sort	string	否	排序标准。默认 relevance。
limit	integer	否	每页结果数（1–50）。默认 20。
offset	integer	否	顺序偏移量（从 0 开始）。

车辆详情

端点：GET /vehicles/details

参数

参数	类型	必填	描述
listing_id	string	是	Autotrader 列表 ID（如 710521849）。

Kelley Blue Book 估值

端点：GET /vehicles/pricing

参数

参数	类型	必填	描述
vin	string	是	17 位车辆识别号。
zip_code	string	否	5 位美国 ZIP 码，用于区域价格调整。默认 90210。
mileage	integer	否	里程表读数，用于里程调整估值。

经销商档案

端点：GET /dealers/details

参数

参数	类型	必填	描述
dealer_id	string	是	Autotrader 经销商 ID（如 100014022）。

参考分类

品牌和型号目录

• GET /reference/makes：列出市场上所有可用车辆品牌。
• GET /reference/models：列出特定品牌关联的型号代码。

/reference/models 参数：

参数	类型	必填	描述
make	string	是	品牌代码（如 TOYOTA、FORD、BMW）。

地理位置查询

端点：GET /locations/lookup

将 5 位邮政编码转换为质心坐标和指定市场区域名称。

参数：

参数	类型	必填	描述
zip_code	string	是	5 位美国 ZIP 码（如 90210）。

搜索关键词建议

端点：GET /reference/keywords

获取前端自动完成框的搜索词建议。

参数：

参数	类型	必填	描述
query	string	是	搜索前缀文本（如 corv、f15、cam）。

错误处理

HTTP 状态	原因	描述
200 OK	成功	请求成功并返回有效数据。
400 Bad Request	输入无效	缺失或格式错误的查询参数。
404 Not Found	资源未找到	列表 ID 或经销商不存在。
422 Unprocessable	偏移量超出范围	分页偏移量超过可用结果总数（offset >= total）。
429 Too Many Requests	超出速率限制	当前计划 API 请求阈值超出。
500 Server Error	内部故障	临时服务中断。

常见问题

• 顺序分页如何工作？ 从 offset=0 开始搜索。每个响应在根级别提供 limit、offset、count、total、hasMore 和 nextOffset。当 hasMore 为 true 时，将 nextOffset 的值作为后续请求的 offset 参数。
• 可以用城市名代替 ZIP 码搜索吗？ 可以。location 参数接受 5 位 ZIP 码（如 90210）以及主要大都市城市名（如 Miami、Los Angeles、Chicago、Dallas、New York）。
• 车辆库存刷新频率如何？ 车辆列表持续同步。价格调整、新增车辆和售出状态更新实时反映。
• 可以评估置换或零售市场价值吗？ 可以。/vehicles/pricing 端点在提供有效 VIN 时提供 Kelley Blue Book 公允购买价格（FPP）、典型经销商挂牌价格和市场价值范围。

最佳实践

• 指定搜索半径：对于密集城市地区，通过设置适当的 radius 值（25 或 50 英里）缩小搜索范围；对于稀有配置或经典车型，使用更宽半径（100 到 250 英里）。
• 利用顺序指针：始终使用前一个响应中的 nextOffset 而非猜测任意偏移量，以防止 422 Unprocessable Entity 边界错误。
• 按品牌和型号过滤：预先按品牌代码过滤可大幅加快高容量库存类别的查询解析时间。

⚠️ 数据可用性

库存可用性、定价、车辆选项和经销商详情由零售汽车列表提供。列表可能因各自销售经销商的事先销售、租赁或价格调整而变化。