문서

매물은 이렇게 생겼습니다

데이터가 한국어 원본에서 오기 때문에 이 중 네 필드는 기본적으로 잘못 읽힙니다. 모두 조용히 실패합니다. 페이지는 잘 그려지고, 다만 틀립니다.

모두가 걸리는 네 가지

Price는 만 원 단위입니다. 4339는 4,339유로가 아니라 약 29,070유로입니다.
Year는 연도가 아니라 YYYYMM입니다. 201902는 2019년 2월이고, FormYear에 2019가 들어 있습니다.
FuelType과 Badge는 한국어입니다. 옆의 de / en 블록을 대신 렌더링하세요.
사진 경로는 상대 경로입니다. 이미지 호스트를 앞에 붙이고, Photo에는 001.jpg를 덧붙이세요.

전체 매물 한 건

{
  "Id": "38421907",
  "Manufacturer": "현대",
  "Model": "그랜저 IG",
  "Badge": "2.4 프리미엄",
  "en": { "manufacturer": "Hyundai", "model": "Grandeur IG", "badge": "2.4 Premium",
          "fuelType": "Gasoline" },
  "de": { "manufacturer": "Hyundai", "model": "Grandeur IG", "badge": "2.4 Premium",
          "fuelType": "Benzin" },
  "Price": 2820,
  "Year": 202103,
  "FormYear": "2021",
  "Mileage": 42150,
  "FuelType": "가솔린",
  "Transmission": "오토",
  "OfficeCityState": "서울",
  "powerPs": 190,
  "Photo": "/carpicture/carpicture05/pic3842/38421907_",
  "priceDrop": { "previousPrice": 2950, "droppedAt": "2026-10-14" }
}

field	meaning
Id	Encar listing id. Pass it to /car to get the full vehicle.
Manufacturer / Model / Badge	Korean source values. Badge is partly Korean — prefer the de / en block below.
de / en	The same car translated: manufacturer, modelGroup, model, badge, fuelType. Render these.
Price	In units of 10,000 KRW. EUR ≈ Price × 6.7, so 4339 is about €29,070 — not €4,339.
Year	YYYYMM, not a year: 201902 is February 2019. FormYear holds the plain "2019".
Mileage	Kilometres, as an integer.
FuelType	Korean. The translated value is in de.fuelType / en.fuelType.
Photo / Photos[]	Relative paths. Prefix them with the image host; with Photo, append 001.jpg.
priceDrop	Present when the seller cut the price: previousPrice, droppedAt.
powerPs / powerKw	Engine output, where the trim is known.
OfficeCityState	Where the car stands, as a Korean region name.

← 전체 문서

API 키 받기

무료 · 하루 100회 요청

이용 시작 →

이어서 읽기

검색 파라미터 — GET /cars

한 번의 호출에서 자유롭게 조합할 수 있습니다. 응답에 total, page, count, results[]가 있으므로 두 번째 요청 없이 total로 페이지를 넘길 수 있습니다.

더 읽기 →

요청 한도와 오류

모든 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset이 들어 있어, 한도를 맞닥뜨리는 대신 다가오는 것을 볼 수 있습니다.

더 읽기 →

한국 중고차 시장, API로

한국의 중고차 수출은 해마다 늘고 있지만, 공급의 거의 전부는 외국 구매자를 위해 만들어지지 않은 한국어 플랫폼에 있습니다. 이 API가 그 사이의 레이어입니다.

더 읽기 →