documentation
À quoi ressemble une annonce
Les données viennent d'une source coréenne : quatre de ces champs sont donc lus de travers par défaut. Chaque erreur est silencieuse — votre page s'affiche, elle est simplement fausse.
Les quatre qui piègent tout le monde
- Price est en unités de 10 000 KRW. 4339 vaut environ 29 070 €, pas 4 339 €.
- Year est AAAAMM, pas une année. 201902 est février 2019 ; FormYear contient le 2019 simple.
- FuelType et Badge sont en coréen. Affichez plutôt le bloc de / en qui les accompagne.
- Les chemins de photos sont relatifs. Préfixez-les par l'hôte d'images et, pour Photo, ajoutez 001.jpg.
Une annonce complète
{
"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. |
Obtenez votre clé API
Gratuit · 100 requêtes par jour
À lire ensuite
Paramètres de recherche — GET /cars
Combinez-les librement en un seul appel. La réponse porte total, page, count et results[], vous pouvez donc paginer sur total sans seconde requête.
Lire la suite →
Limites et erreurs
Chaque réponse porte X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset : vous voyez une limite venir au lieu de la découvrir.
Lire la suite →
Le marché coréen de l'occasion, sous forme d'API
La Corée du Sud exporte chaque année davantage de voitures d'occasion, et presque toute l'offre se trouve sur des places de marché en coréen qui n'ont jamais été conçues pour des acheteurs étrangers. Cette API est la couche intermédiaire.
Lire la suite →