API参考
文档
EnCarAPI文档。了解如何通过API端点访问韩国汽车数据。集成指南和代码示例。
行业经验
在韩国市场拥有多年经验的汽车数据API提供商。
全周支持
支持团队每周7天提供API集成帮助。
24/7服务
全天候监控,确保可靠的数据交付。
实时列表提醒
新车辆列表发布后即可通过API即时访问。
CSV 下载
以 CSV 格式下载品牌、车型和徽标列表 - 缓存后即可省去实时分面调用。
灵活的导出格式
支持CSV、JSON、Excel和自定义格式,轻松集成。
基础URL
所有API请求都发送到以下基础URL:
url
https://api.encarapi.com例如,获取车辆列表:
http
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true身份验证
使用API密钥验证您的请求。通过查询参数或Authorization头传递。
bash
# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"
# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEY集成工作流程
按照以下四个步骤与EnCarAPI集成。
1
获取可用筛选条件
获取所有可用的筛选值(品牌、型号、配置、颜色等)
GET /filters2
获取车辆列表
使用品牌、型号、年份、价格等筛选条件获取分页列表。
GET /offers?page=13
追踪变更
获取某个日期的变更ID,然后轮询新增、修改和删除的列表。
GET /change_id → GET /changes4
获取列表详情
通过inner_id获取特定列表的完整详情。
GET /offer?inner_id=...API端点
所有可用于访问韩国车辆数据的端点。
下拉列表数据(CSV)
将品牌、车型和徽标列表以 CSV 格式下载并缓存,然后据此构建你的下拉列表 - 无需每次点击调用分面接口,也无需离线映射。每个文件都包含一个数量列,徽标文件还包含车身样式的细分(Coupe/Sedan/Cabrio)。
下载一次,缓存备用 - 每日更新
https://api.encarapi.com/api/taxonomy/badges.csv?api_key=YOUR_KEY
所有品牌、车型和徽标值(含 Coupe/Sedan/Cabrio)及其数量
下载时请附上您的 API 密钥 - 在文件 URL 后加上 ?api_key=YOUR_KEY。文件受密钥保护,没有有效密钥任何人都无法下载。
数据新鲜度
完整目录每天刷新,最新车源每2小时抓取一次,已售车辆每小时移除。
缓存时长建议
- 筛选值、分类 CSV 和 /api/nav:缓存24小时
- 车辆车源(/api/catalog):缓存1至2小时
- 车辆详情(/api/vehicle/:id):缓存24小时
请从你自己的数据库提供车源并按此频率刷新,而不是在用户每次点击时进行实时调用。
常见问题
准备好开始了吗?
通过Telegram联系我们获取API凭证,立即开始访问韩国汽车数据。