API 레퍼런스

문서

EnCarAPI 문서입니다. 직접 API 엔드포인트를 통해 한국 자동차 데이터에 접근하는 방법을 알아보세요. 연동 가이드 및 코드 예제 포함.

업계 경험

한국 시장에서 수년간의 경험을 보유한 자동차 데이터 API 제공업체.

주 7일 지원

API 연동 지원을 위해 주 7일 운영되는 지원팀.

24시간 서비스

안정적인 데이터 제공을 위한 24시간 모니터링.

실시간 매물 알림

새로운 자동차 매물이 등록되는 즉시 API로 접근하세요.

일일 데이터 내보내기

시장 분석을 위한 활성 및 삭제 매물의 일일 내보내기를 받으세요.

유연한 내보내기 형식

간편한 연동을 위해 CSV, JSON, Excel 및 맞춤 형식으로 데이터를 받으세요.

기본 URL

모든 API 요청은 다음 기본 URL로 이루어집니다:

url

https://encarapi.com/api/v2/encar

예를 들어, 매물을 가져오려면:

http

GET https://encarapi.com/api/v2/encar/offers?page=1&api_key=YOUR_API_KEY

인증

API 키를 사용하여 요청을 인증합니다. 쿼리 매개변수 또는 Authorization 헤더로 전달하세요.

bash

GET https://encarapi.com/api/v2/encar/offers?api_key=YOUR_API_KEY

# Or via header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://encarapi.com/api/v2/encar/offers?page=1

연동 워크플로

EnCarAPI와 연동하기 위한 네 단계를 따르세요.

사용 가능한 필터 가져오기

가능한 모든 필터 값(제조사, 모델, 구성, 색상 등)을 조회합니다.

GET /filters

차량 매물 가져오기

제조사, 모델, 연식, 가격 등의 선택적 필터를 사용하여 페이지별 매물을 조회합니다.

GET /offers?page=1

변경사항 추적

날짜에 대한 변경 ID를 가져온 다음, 추가, 변경 및 삭제된 매물을 폴링합니다.

GET /change_id → GET /changes

매물 상세정보 가져오기

inner_id를 사용하여 특정 매물의 전체 상세정보를 조회합니다.

GET /offer?inner_id=...

API 엔드포인트

한국 차량 데이터에 접근하기 위한 모든 사용 가능한 엔드포인트.

일일 내보내기

다양한 형식으로 전체 데이터 내보내기를 다운로드하세요. 파일은 매일 생성되며 다운로드할 수 있습니다.

데이터 보관

파일은 최소 3일 이상 보관됩니다.

일일 업데이트

매일 새로운 파일을 다운로드할 수 있습니다.

CSV 형식

CSV 파일은 파이프(|)를 열 구분자로 사용합니다.

사용 가능한 내보내기 파일

형식	전체 활성 매물	일일 신규 매물	일일 삭제 매물
CSV	`all_active.csv`	`new_daily.csv`	`removed_daily.csv`
JSON	`all_active.json`	`new_daily.json`	`removed_daily.json`
Excel	`all_active.xlsx`	`new_daily.xlsx`	`removed_daily.xlsx`

다운로드 예제

bash

# Download all active listings as CSV
curl -L -X GET 'https://encarapi.com/2025-03-15/all_active.csv' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -o daily_car_data.csv

bash

# Download new daily listings as JSON
curl -L -X GET 'https://encarapi.com/2025-03-15/new_daily.json' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -o new_listings.json

bash

# Using wget
wget --method GET \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  'https://encarapi.com/2025-03-15/all_active.xlsx'

자주 묻는 질문

시작할 준비가 되셨나요?

텔레그램으로 문의하시면 API 인증 정보를 받고 오늘부터 한국 자동차 데이터에 접근할 수 있습니다.

텔레그램으로 문의