Source API · Encar · South Korea # Encar API for cars from Korea — as JSON, no scraper of your own Encar is South Korea's largest used-car marketplace: dealers and private sellers list cars at a fixed price. apiauto.space returns every Encar listing in the same record as Che168, Copart and IAAI: the price in won and dollars, mileage, photos, region and every field of the source. The key works from any country — no Korean proxy needed. - **Source**: encar.com · market=kr - **Region**: South Korea - **Data**: Listings, prices, photos, changes - **Status**: Running · refreshed hourly ## What an Encar record holds The same keys in every market; on the right, the values of a real car from the catalog. What Encar does not give comes as null, never a guess. ### Car - `title` Year, make, model and trim in one line `"2021 BMW 7 Series (G11) 740Li xD…` - `brand` In Latin script, the same in every market `"BMW"` - `model` The model family, as in other markets `"7 Series"` - `trim` The trim in Latin script `"740Li xDrive Design Pure Excelle…` - `year` Model year `2021` - `mileage_km` Mileage in kilometres `179132` - `fuel` A canonical English value `"gasoline"` ### Price - `price` The price in won, as on Encar `34900000.00 KRW` - `price_usd` The same price in dollars `"25988.47"` - `raw.fx.usd_per_unit` The ECB daily rate it was converted at `"0.0007446554"` ### Place and photos - `location.region` The seller's region `"Gyeonggi"` - `photo_count` Usually 4 photos from Encar's search `4` - `photos.0` A signed link, valid for about a day `"api.apiauto.space/img/encar:4307…` - `listing_url` The listing on encar.com `"fem.encar.com/cars/detail/430791…` ### Status - `is_active` On sale now `true` - `first_seen_at` When the car entered the catalog, UTC `"2026-11-02T14:34:16.763020Z"` - `disappeared_at` Cars taken off sale stay for 14 days `null` ### Encar only · raw - `raw.sell_type` Sale, rental or lease `"normal"` - `raw.has_accident` The accident flag as Encar passes it `false` - `raw.condition` Encar's available reports `["Record"]` - `raw.form_year` Year and month, YYYYMM `"202101"` - `raw.source_values.brand` The original Korean spelling `"BMW"` ### Not in Encar - `vin` About one car in a thousand has a VIN `null` - `transmission` The catalog has no gearbox `null` - `engine_cc` Nor engine size `null` encar:43079113 2021 BMW 7 Series (G11) 740Li xDrive Design Pure Excellence · 179,132 km ## Request and response The four requests people usually start with. The key goes in the X-API-Key header; the answer is JSON. A page of cars by filters and the next page's cursor GET `https://api.apiauto.space/v1/cars?market=kr&limit=2` cURL: ```bash curl -s "https://api.apiauto.space/v1/cars?market=kr&limit=2" \ -H "X-API-Key: $APIAUTO_KEY" ``` JavaScript: ```js const response = await fetch( "https://api.apiauto.space/v1/cars?market=kr&limit=2", { headers: { "X-API-Key": process.env.APIAUTO_KEY } }, ); if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`); const data = await response.json(); ``` Python: ```python import os import httpx data = httpx.get( "https://api.apiauto.space/v1/cars?market=kr&limit=2", headers={"X-API-Key": os.environ["APIAUTO_KEY"]}, timeout=30, ).raise_for_status().json() ``` PHP: ```php ["X-API-Key: " . getenv("APIAUTO_KEY")], CURLOPT_RETURNTRANSFER => true, ]); $data = json_decode(curl_exec($ch), true); ``` 200 OK · sample response: ```json { "items": [ { "id": "encar:43079113", "market": "kr", "source": "encar", "source_id": "43079113", "title": "2021 BMW 7 Series (G11) 740Li xDrive Design Pure Excellence", "brand": "BMW", "model": "7 Series", "generation": "7 Series (G11)", "trim": "740Li xDrive Design Pure Excellence", "year": 2021, "mileage_km": 179132, "fuel": "gasoline", "transmission": null, "engine_cc": null, "body_type": null, "color": null, "vin": null, "price": { "amount": "34900000.00", "currency": "KRW" }, "price_usd": "25988.47", "location": { "country": "KR", "region": "Gyeonggi", "city": null }, "photos": [ "https://api.apiauto.space/img/encar:43079113/1.jpg?exp=…&sig=…", "https://api.apiauto.space/img/encar:43079113/2.jpg?exp=…&sig=…" ], "photo_count": 4, "listing_url": "https://fem.encar.com/cars/detail/43079113", "is_active": true, "first_seen_at": "2026-11-02T14:34:16.763020Z", "last_seen_at": "2026-11-02T14:34:16.763020Z", "disappeared_at": null, "updated_at": "2026-11-02T14:34:16.763020Z", "raw": { "fx": { "date": "2026-11-02", "source": "ECB", "currency": "KRW", "usd_per_unit": "0.0007446554" }, "badge": "740Li xDrive 디자인 퓨어 엑셀런스", "trust": [ "Warranty" ], "has_vin": false, "condition": [ "Record" ], "form_year": "202101", "sell_type": "normal", "body_class": null, "office_city": "경기", "badge_detail": null, "has_accident": false, "service_mark": [ "EncarDiagnosisP1" ], "source_values": { "fuel": "가솔린", "trim": "740Li xDrive 디자인 퓨어 엑셀런스", "brand": "BMW", "model": "7시리즈 (G11)", "region": "경기", "sell_type": "일반", "transmission": null }, "has_inspection": false }, "source_mode": "replica" }, { "id": "encar:43079086", "market": "kr", "source": "encar", "source_id": "43079086", "title": "2022 Volvo XC60 2 Gen B5 Inscription", "brand": "Volvo", "model": "XC60", "generation": "XC60 2 Gen", "trim": "B5 Inscription", "year": 2022, "mileage_km": 60699, "fuel": "gasoline", "transmission": null, "engine_cc": null, "body_type": null, "color": null, "vin": null, "price": { "amount": "40800000.00", "currency": "KRW" }, "price_usd": "30381.94", "location": { "country": "KR", "region": "Gyeonggi", "city": null }, "photos": [ "https://api.apiauto.space/img/encar:43079086/1.jpg?exp=…&sig=…", "https://api.apiauto.space/img/encar:43079086/2.jpg?exp=…&sig=…" ], "photo_count": 4, "listing_url": "https://fem.encar.com/cars/detail/43079086", "is_active": true, "first_seen_at": "2026-11-02T14:34:16.763020Z", "last_seen_at": "2026-11-02T14:34:16.763020Z", "disappeared_at": null, "updated_at": "2026-11-02T14:34:16.763020Z", "raw": { "fx": { "date": "2026-11-02", "source": "ECB", "currency": "KRW", "usd_per_unit": "0.0007446554" }, "badge": "B5 인스크립션", "trust": [], "has_vin": false, "condition": [ "Inspection", "Record" ], "form_year": "202207", "sell_type": "normal", "body_class": null, "office_city": "경기", "badge_detail": null, "has_accident": false, "service_mark": [], "source_values": { "fuel": "가솔린", "trim": "B5 인스크립션", "brand": "볼보", "model": "XC60 2세대", "region": "경기", "sell_type": "일반", "transmission": null }, "has_inspection": false }, "source_mode": "replica" } ], "next_cursor": "…", "count": null } ``` The cars in the responses are real, from the catalog when the site was built; photos are cut to two and event ids are made up. ## Build a request Pick filters and the address and code build themselves. The market is fixed: market=kr returns Encar cars only. GET `https://api.apiauto.space/v1/cars?market=kr&brand=Hyundai&limit=20` cURL: ```bash curl -s "https://api.apiauto.space/v1/cars?market=kr&brand=Hyundai&limit=20" \ -H "X-API-Key: $APIAUTO_KEY" ``` JavaScript: ```js const response = await fetch( "https://api.apiauto.space/v1/cars?market=kr&brand=Hyundai&limit=20", { headers: { "X-API-Key": process.env.APIAUTO_KEY } }, ); if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`); const data = await response.json(); ``` Python: ```python import os import httpx data = httpx.get( "https://api.apiauto.space/v1/cars?market=kr&brand=Hyundai&limit=20", headers={"X-API-Key": os.environ["APIAUTO_KEY"]}, timeout=30, ).raise_for_status().json() ``` PHP: ```php ["X-API-Key: " . getenv("APIAUTO_KEY")], CURLOPT_RETURNTRANSFER => true, ]); $data = json_decode(curl_exec($ch), true); ``` ## Use cases 1. **A catalog on an importer's site** — 01 A catalog on an importer's siteEncar cars with photos and dollar prices on your site; once an hour, pick up new and removed cars from the change feed. Method`GET /v1/cars · /v1/changes` 2. **Search for a client** — 02 Search for a clientA manager searches by make, year, mileage and budget and sends the client photos and the listing link. Method`GET /v1/cars?brand=…&year_min=…` 3. **Price tracking** — 03 Price trackingThe price_drop feed shows which cars got cheaper since the last poll, with a percentage threshold. Method`GET /v1/changes?type=price_drop` 4. **A car-finder Telegram bot** — 04 A car-finder Telegram botThe bot sends a client fresh cars for their filter on its own: new arrivals come as added events. Method`GET /v1/changes?type=added` ## About the source What only Encar has, which makes the catalog holds and where the data's limits are. ### Encar fields in raw Whatever only Encar has stays in the `raw` object as it is: nothing is dropped. | Field | Meaning | | --- | --- | | `sell_type` | Sale type: a normal sale, a rental or a lease. Rentals and leases may show less than the full price. | | `has_accident`, `has_inspection`, `has_vin` | Listing flags as Encar sends them. | | `condition`, `trust`, `service_mark` | Encar marks: available reports, warranty, diagnosis (e.g. EncarDiagnosisP1). | | `form_year` | Year and month as YYYYMM, as on Encar. | | `badge`, `badge_detail` | The trim as written on Encar, in Korean. | | `office_city` | The seller's city, in Korean. | | `source_values` | Original spellings of make, model, trim, fuel and region. | | `fx` | The rate behind `price_usd`: date, source (ECB), currency. | ### Encar makes in the catalog The most frequent makes in the catalog; the `brand` parameter finds them in this spelling, ignoring case, spaces and hyphens. | Make | Cars in the catalog | | --- | --- | | Hyundai | 34,911 | | Kia | 33,884 | | BMW | 12,666 | | Mercedes-Benz | 12,511 | | Genesis | 8,141 | | KGM (SsangYong) | 6,079 | | Chevrolet | 5,634 | | Renault Korea | 4,622 | | Audi | 3,166 | | Porsche | 2,605 | | Land Rover | 2,089 | | MINI | 1,971 | The full list with car counts is `GET /v1/references/brands?market=kr`, a make's models are in `/v1/references/models`. References are free and never touch the quota. ### New cars and price changes The feed `GET /v1/changes?market=kr&since=…` returns events: new cars (`added`), cars taken off sale (`disappeared`), price drops and rises (`price_drop`, `price_up`) above a percentage threshold. A site or a bot learns about new arrivals without rereading the whole catalog. The feed comes with Pro, Max and the demo; each event costs one record. ### Encar data boundaries - A VIN on about 0.1% of cars: checking Korean cars' history by VIN through the API will not work. - The source has no transmission or engine size. - Usually four photos, from Encar search. - Rentals and leases may show less than the full price — see `raw.sell_type` . - Cars taken off sale stay in the API for 14 more days with `is_active=false` . - The age of the copy comes in the `X-Data-Age-Seconds` header of every answer. ### Your own Encar scraper or an API A scraper of your own gives full control, but you keep it alive: blocks, site changes, translating Korean names, storing photos. An API takes that work away but returns only what is in the record and in `raw`. [A scraper or a ready API — compared point by point](https://apiauto.space/en/parser-vs-api/). ## Frequently asked questions ### 01Is this the official Encar API? No. apiauto.space is not affiliated with Encar. Encar has no open API for third-party developers, so its data is usually taken by scraping the site. We keep a copy of the catalog and serve it in one format through our own API. ### 02Do I need a Korean proxy or IP? No. Requests go to our API, not to Encar, and the key works from any country. Photos are served by our server too. ### 03How often are Encar cars refreshed? The Encar copy is refreshed on a schedule, hourly by target. The data age comes in the X-Data-Age-Seconds header of every answer; current market freshness is in /v1/references/markets. ### 04Is the data in English? Makes and models are in Latin script, field values are canonical English, and the original Korean spellings are in raw.source_values. ### 05May I show Encar cars on my site? Yes, in your own product and to your customers, photos included. Reselling the data and full dumps need an Enterprise agreement (offer, section 6). ### 06How much does the Encar API cost? The Start plan is $59 a month for one market, e.g. Korea only: 100,000 cars a month. The quota counts cars returned, not requests; references and photos are free. The demo is one day and 100 requests, free. ## Other APIs and guides - [Source API **Che168 API**](https://apiauto.space/en/che168-api/) - [Source API **Copart API**](https://apiauto.space/en/copart-api/) - [Source API **IAAI API**](https://apiauto.space/en/iaai-api/) - [Guide **A used-car catalog for an importer's site**](https://apiauto.space/en/importers/) - [Developers **Documentation**](https://apiauto.space/en/docs/) ## Get an Encar test key - One day and 100 requests free, no card - All three markets and the change feed: compare Korea with China and the USA - The key arrives in Telegram within a minute — no forms, no calls --- Page: https://apiauto.space/en/encar-api/