docs
What a listing looks like
The data comes from a Korean source, so four of these fields are read wrong by default. Each one fails silently — your page renders, it is simply incorrect.
The four that catch everyone
- Price is in units of 10,000 KRW. 4339 is about €29,070, not €4,339.
- Year is YYYYMM, not a year. 201902 is February 2019; FormYear holds the plain 2019.
- FuelType and Badge are Korean. Render the de / en block beside them instead.
- Photo paths are relative. Prefix them with the image host, and with Photo append 001.jpg.
A full listing
{
"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. |
Get your API key
Free tier · 100 requests a day
Keep reading
Search parameters — GET /cars
Combine any of these on a single call. The answer carries total, page, count and results[], so you can paginate off total without a second request.
Read more →
Rate limits and errors
Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, so you can see a limit coming rather than discover it.
Read more →
The Korean used car market, as an API
South Korea exports more used cars every year, and almost all of that supply sits on Korean-language marketplaces that were never built for foreign buyers. This API is the layer in between.
Read more →