문서
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 를 붙이면 됩니다. 파일은 키로 보호되어 있어 유효한 키가 없으면 아무도 다운로드할 수 없습니다.
데이터 최신성
카탈로그(가격, 주행거리, 신규 및 판매완료 매물)는 약 5시간마다 갱신되며, 하루에 한 번 더 깊은 갱신이 이루어집니다. 차량 상세정보(사양, 사진, 상태, 사고 이력 보고서)는 자체적인 더 느린 주기를 따르며, 보통 변경 후 3주 이내에 반영되고 카탈로그에서 관련 변화가 감지되면 더 빨리 반영됩니다.
카탈로그 수집 범위
카탈로그는 일반 매물만 다루며, 리스와 렌트 매물은 카탈로그 전체에서 의도적으로 제외됩니다. 리스·렌트는 구매 가격이 아니라 월 납입금 기준으로 가격이 책정되므로, 함께 섞이면 Price 필드 값이 왜곡될 수 있습니다. 리스·렌트 매물은 대신 GET /api/catalog/leasing을 이용하세요.
캐시 유지 기간
- 필터 값, 분류 체계 CSV, /api/nav: 24시간 캐시
- 차량 매물(/api/catalog): 4~6시간 캐시
- 차량 상세(/api/vehicle/:id): 24시간 캐시
이것이 Starter 모델입니다: 사용자가 클릭할 때마다 실시간으로 호출하지 말고, 자체 데이터베이스에서 매물을 제공하고 이 주기에 맞춰 갱신하세요. 이 플랜에는 일일 카탈로그 조회량 한도가 있으며, 실시간 조회를 위한 것이지 전체 로컬 사본을 보관하기 위한 것이 아닙니다.
전체 로컬 사본이 필요하신가요?
Business 및 Scale 플랜에는 GET /api/catalog/export(일일 한도에 포함되지 않는, 매일 생성되는 전체 CSV 스냅샷)와 GET /api/catalog/changes?since=...(마지막 동기화 이후 추가, 업데이트, 재등록, 삭제된 매물)가 포함됩니다. 내보내기로 데이터베이스를 한 번 초기화한 다음 changes를 폴링하여 최신 상태를 유지하면, 더 이상 카탈로그 전체를 다시 가져올 필요가 없습니다. Scale 플랜에서는 일일 카탈로그 조회량 한도가 완전히 사라집니다.
중복 매물
한국 딜러들은 노출을 늘리기 위해 동일한 실제 차량을 서로 다른 매물 ID로 두 번 등록하는 경우가 흔합니다 - 가격, 주행거리, 연식, 모델/등급이 모두 동일합니다. 저희는 이를 감지해서 추가로 등록된 매물에 IsDuplicate: true와 DuplicateOf: <원본 매물 ID>를 표시합니다. 원본 매물에는 표시가 붙지 않습니다. 중복은 표시만 될 뿐 삭제되지 않으므로 처리 방식은 직접 선택할 수 있습니다 - /api/catalog 또는 /api/catalog/leasing에 exclude_duplicates=true를 전달하면 서버에서 필터링됩니다.
자주 묻는 질문
시작할 준비가 되셨나요?
텔레그램으로 문의하시면 API 인증 정보를 받고 오늘부터 한국 자동차 데이터에 접근할 수 있습니다.