AutoScout24 API

Structured JSON data from AutoScout24 — Europe's largest used-car marketplace. 11 endpoints: search, listing details (id or URL), similar listings, dealers, makes & models, taxonomy, location autocomplete.

原始信息汇总

好的，这是根据您提供的HTML内容总结的AutoScout24 API数据集详情。

数据集概述：AutoScout24 API

该API提供对欧洲最大二手车市场 AutoScout24 的结构化JSON数据访问，覆盖德国、奥地利、比利时、西班牙、法国、意大利、卢森堡、荷兰等国家。

核心功能与端点

API 共提供 11个端点，远超同类竞品。

方法	路径	描述
GET	/api/v1/search	分页车辆搜索，支持20+筛选条件
GET	/api/v1/listings/{id}	通过36位GUID获取完整车辆详情
GET	/api/v1/listings/by-url	通过AutoScout24原始URL获取车辆详情
GET	/api/v1/listings/{id}/similar	获取最多20条相似车辆列表
GET	/api/v1/makes	获取288个车辆品牌
GET	/api/v1/makes/{makeIdOrSlug}/models	获取指定品牌下的车型、车系等
GET	/api/v1/taxonomy	获取车身类型、燃料类型、设备、颜色等完整分类信息
GET	/api/v1/dealers/{slug}	获取经销商详细信息
GET	/api/v1/dealers/{slug}/listings	获取经销商的库存列表（分页）
GET	/api/v1/dealers/{slug}/reviews	获取经销商的评分与评论
GET	/api/v1/locations/autocomplete	城市/邮编自动补全查询

核心数据特点

• 数据结构：全部返回结构化的JSON数据，无需解析HTML。
• 数据规模：可搜索超过700,000条车辆列表。
• 分页限制：搜索和经销商库存列表每页最多返回20条数据，最多可获取200页（即单次查询最多4,000条结果）。
• 标识符说明：id 是稳定的36位UUID；identifier.legacyId 是旧版数字ID；identifier.offerReference 是经销商的内部SKU。

主要参数说明

• atype：车辆类型（C-汽车, M-摩托车, V-厢式货车, B-房车, T-卡车）
• country / cy：国家代码（D-德国, A-奥地利, B-比利时, I-意大利, E-西班牙, F-法国, L-卢森堡, NL-荷兰）
• ustate：使用状态（N,U-默认新/旧, N-仅新车, U-仅二手车）
• sort：排序方式（standard-默认, price-价格, age-注册日期, mileage-里程, year-年份, power-马力）
• desc：排序方向（0-升序, 1-降序）
• fuel：燃料类型（B-汽油, D-柴油, E-电动, H-氢能, L-LPG, C-CNG, 2-混动(汽), 3-混动(柴), M-乙醇, O-其他）

API 优势

• 端点最多：提供11个端点，覆盖经销商信息、库存和评价、车型分类等竞品缺失功能。
• 性价比高：提供多种订阅方案（Basic免费，Pro $10/月，Ultra $35/月，Mega $99/月），强调性价比。
• 可靠稳定：基于指纹管理的爬虫基础设施，KV缓存和自动故障转移，目标服务等级达99%以上。

常见错误码

状态码	含义	是否重试
200	成功	否
404	未找到车辆或经销商	否
422	参数验证错误	否
429	上游限流	是（建议5秒后退）
502	上游数据获取失败	是（建议退避后重试）