Doku
Wie ein Inserat aussieht
Die Daten stammen aus einer koreanischen Quelle, deshalb werden vier dieser Felder standardmäßig falsch gelesen. Jeder dieser Fehler bleibt stumm — Ihre Seite rendert, sie ist nur falsch.
Die vier, über die alle stolpern
- Price steht in Einheiten zu 10.000 KRW. 4339 sind rund 29.070 €, nicht 4.339 €.
- Year ist JJJJMM, kein Jahr. 201902 ist Februar 2019; FormYear enthält das schlichte 2019.
- FuelType und Badge sind koreanisch. Rendern Sie stattdessen den de/en-Block daneben.
- Bildpfade sind relativ. Stellen Sie den Bild-Host voran, bei Photo zusätzlich 001.jpg anhängen.
Ein vollständiges Inserat
{
"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. |
Ihren API-Key holen
Kostenlos · 100 Anfragen pro Tag
Weiterlesen
Suchparameter — GET /cars
Beliebig kombinierbar in einem Aufruf. Die Antwort enthält total, page, count und results[], Sie können also ohne zweite Anfrage über total paginieren.
Weiterlesen →
Limits und Fehler
Jede Antwort trägt X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset — Sie sehen ein Limit kommen, statt es zu entdecken.
Weiterlesen →
Der koreanische Gebrauchtwagenmarkt als API
Südkorea exportiert jedes Jahr mehr Gebrauchtwagen, und fast das gesamte Angebot liegt auf koreanischsprachigen Marktplätzen, die nie für ausländische Käufer gebaut wurden. Diese API ist die Schicht dazwischen.
Weiterlesen →