documentazione
Com'è fatto un annuncio
I dati arrivano da una fonte coreana, quindi quattro di questi campi vengono letti male per impostazione predefinita. Ogni errore è silenzioso: la vostra pagina si disegna, è solo sbagliata.
I quattro che fregano tutti
- Price è in unità da 10.000 KRW. 4339 sono circa 29.070 €, non 4.339 €.
- Year è AAAAMM, non un anno. 201902 è febbraio 2019; FormYear contiene il semplice 2019.
- FuelType e Badge sono in coreano. Mostrate invece il blocco de / en accanto.
- I percorsi delle foto sono relativi. Anteponete l'host delle immagini e, con Photo, aggiungete 001.jpg.
Un annuncio completo
{
"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. |
Ottieni la tua chiave API
Gratis · 100 richieste al giorno
Da leggere dopo
Parametri di ricerca — GET /cars
Combinateli liberamente in una sola chiamata. La risposta porta total, page, count e results[], quindi potete paginare su total senza una seconda richiesta.
Continua a leggere →
Limiti ed errori
Ogni risposta porta X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset: vedete arrivare un limite invece di scoprirlo.
Continua a leggere →
Il mercato coreano dell'usato, come API
La Corea del Sud esporta ogni anno più auto usate, e quasi tutta l'offerta sta su portali in coreano mai pensati per acquirenti stranieri. Questa API è lo strato intermedio.
Continua a leggere →