문서
EnCarAPI 문서입니다. 직접 API 엔드포인트를 통해 한국 자동차 데이터에 접근하는 방법을 알아보세요. 연동 가이드 및 코드 예제 포함.
업계 경험
한국 시장에서 수년간의 경험을 보유한 자동차 데이터 API 제공업체.
주 7일 지원
API 연동 지원을 위해 주 7일 운영되는 지원팀.
24시간 서비스
안정적인 데이터 제공을 위한 24시간 모니터링.
실시간 매물 알림
새로운 자동차 매물이 등록되는 즉시 API로 접근하세요.
CSV 다운로드
제조사, 모델, 배지 목록을 CSV로 다운로드하세요 - 캐시하면 실시간 패싯 호출을 생략할 수 있습니다.
유연한 내보내기 형식
간편한 연동을 위해 CSV, JSON, Excel 및 맞춤 형식으로 데이터를 받으세요.
기본 URL
모든 API 요청은 다음 기본 URL로 이루어집니다:
https://api.encarapi.com예를 들어, 매물을 가져오려면:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true인증
API 키를 사용하여 요청을 인증합니다. 쿼리 매개변수 또는 Authorization 헤더로 전달하세요.
# 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와 연동하기 위한 네 단계를 따르세요.
사용 가능한 필터 가져오기
가능한 모든 필터 값(제조사, 모델, 구성, 색상 등)을 조회합니다.
GET /filters차량 매물 가져오기
제조사, 모델, 연식, 가격 등의 선택적 필터를 사용하여 페이지별 매물을 조회합니다.
GET /offers?page=1변경사항 추적
날짜에 대한 변경 ID를 가져온 다음, 추가, 변경 및 삭제된 매물을 폴링합니다.
GET /change_id → GET /changes매물 상세정보 가져오기
inner_id를 사용하여 특정 매물의 전체 상세정보를 조회합니다.
GET /offer?inner_id=...API 엔드포인트
한국 차량 데이터에 접근하기 위한 모든 사용 가능한 엔드포인트.
드롭다운 데이터(CSV)
제조사, 모델, 배지 목록을 CSV로 다운로드해 캐시하고 이를 바탕으로 드롭다운을 구성하세요 - 클릭할 때마다 하는 패싯 호출이나 오프라인 매핑이 필요 없습니다. 각 파일에는 개수 열이 포함되며, 배지 파일에는 바디 스타일 구분(Coupe/Sedan/Cabrio)이 포함됩니다.
한 번 다운로드해 캐시하세요 - 매일 업데이트
매물 수가 포함된 전체 제조사
개수가 포함된 전체 제조사·모델 조합
개수가 포함된 전체 제조사·모델·배지 값(Coupe/Sedan/Cabrio 포함)
다운로드하려면 API 키를 추가하세요 - 파일 URL 뒤에 ?api_key=YOUR_KEY 를 붙이면 됩니다. 파일은 키로 보호되어 있어 유효한 키가 없으면 아무도 다운로드할 수 없습니다.
데이터 최신성
전체 카탈로그는 매일 갱신되고, 최신 매물은 2시간마다 반영되며, 판매 완료 차량은 매시간 제거됩니다.
캐시 유지 기간
- 필터 값, 분류 체계 CSV, /api/nav: 24시간 캐시
- 차량 매물(/api/catalog): 1~2시간 캐시
- 차량 상세(/api/vehicle/:id): 24시간 캐시
사용자가 클릭할 때마다 실시간으로 호출하지 말고, 자체 데이터베이스에서 매물을 제공하고 이 주기에 맞춰 갱신하세요.
자주 묻는 질문
시작할 준비가 되셨나요?
텔레그램으로 문의하시면 API 인증 정보를 받고 오늘부터 한국 자동차 데이터에 접근할 수 있습니다.