API источника · Encar · Южная Корея # API Encar для авто из Кореи — в JSON, без своего парсера Encar — крупнейшая площадка подержанных авто Южной Кореи: дилеры и частные продавцы выставляют машины по фиксированной цене. apiauto.space отдаёт каждое объявление Encar в той же записи, что у Che168, Copart и IAAI: цена в вонах и долларах, пробег, фото, регион и все поля источника. Ключ работает из любой страны — корейский прокси не нужен. - **Источник**: encar.com · market=kr - **Регион**: Южная Корея - **Данные**: Объявления, цены, фото, изменения - **Статус**: Работает · обновление каждый час ## Что содержит запись Encar Одни и те же ключи у всех рынков; справа — значения настоящей машины из каталога. Чего Encar не даёт, приходит как null, а не догадка. ### Машина - `title` Год, марка, модель и комплектация одной строкой `"2020 Kia K5 3 Gen 1.6 Turbo Nobl…` - `brand` Латиницей, одинаково во всех рынках `"Kia"` - `model` Семейство модели, как на других рынках `"K5"` - `trim` Комплектация в латинице `"1.6 Turbo Noblesse"` - `year` Год выпуска `2020` - `mileage_km` Пробег в километрах `70024` - `fuel` Каноническое английское значение `"gasoline"` ### Цена - `price` Цена в вонах, как на Encar `17700000.00 KRW` - `price_usd` Та же цена в долларах `"13180.40"` - `raw.fx.usd_per_unit` Дневной курс ЕЦБ, по которому посчитано `"0.0007446554"` ### Место и фото - `location.region` Регион продавца `"Incheon"` - `photo_count` Обычно 4 фото из поиска Encar `4` - `photos.0` Подписанная ссылка, живёт около суток `"api.apiauto.space/img/encar:4308…` - `listing_url` Объявление на encar.com `"fem.encar.com/cars/detail/430822…` ### Статус - `is_active` В продаже сейчас `true` - `first_seen_at` Когда машина появилась в каталоге, UTC `"2026-11-03T02:17:42.264668Z"` - `disappeared_at` Снятые с продажи остаются 14 дней `null` ### Только у Encar · raw - `raw.sell_type` Продажа, аренда или лизинг `"normal"` - `raw.has_accident` Флаг ДТП, как его передаёт Encar `false` - `raw.condition` Доступные отчёты Encar `["Inspection","Record","Resume"]` - `raw.form_year` Год и месяц, ГГГГММ `"202009"` - `raw.source_values.brand` Исходное корейское написание `"기아"` ### Encar не даёт - `vin` VIN есть примерно у одной машины из тысячи `null` - `transmission` Коробки передач в каталоге нет `null` - `engine_cc` Объёма двигателя тоже `null` encar:43082263 2020 Kia K5 3 Gen 1.6 Turbo Noblesse · 70 024 км ## Запрос и ответ Четыре запроса, с которых обычно начинают. Ключ — в заголовке X-API-Key, ответ — JSON. Страница машин по фильтрам и курсор следующей 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 · пример ответа: ```json { "items": [ { "id": "encar:43082263", "market": "kr", "source": "encar", "source_id": "43082263", "title": "2020 Kia K5 3 Gen 1.6 Turbo Noblesse", "brand": "Kia", "model": "K5", "generation": "K5 3 Gen", "trim": "1.6 Turbo Noblesse", "year": 2020, "mileage_km": 70024, "fuel": "gasoline", "transmission": null, "engine_cc": null, "body_type": null, "color": null, "vin": null, "price": { "amount": "17700000.00", "currency": "KRW" }, "price_usd": "13180.40", "location": { "country": "KR", "region": "Incheon", "city": null }, "photos": [ "https://api.apiauto.space/img/encar:43082263/1.jpg?exp=…&sig=…", "https://api.apiauto.space/img/encar:43082263/2.jpg?exp=…&sig=…" ], "photo_count": 4, "listing_url": "https://fem.encar.com/cars/detail/43082263", "is_active": true, "first_seen_at": "2026-11-03T02:17:42.264668Z", "last_seen_at": "2026-11-03T02:17:42.264668Z", "disappeared_at": null, "updated_at": "2026-11-03T02:17:42.264668Z", "raw": { "fx": { "date": "2026-11-02", "source": "ECB", "currency": "KRW", "usd_per_unit": "0.0007446554" }, "badge": "1.6 터보", "trust": [], "has_vin": false, "condition": [ "Inspection", "Record", "Resume" ], "form_year": "202009", "sell_type": "normal", "body_class": null, "office_city": "인천", "badge_detail": "노블레스", "has_accident": false, "service_mark": [], "source_values": { "fuel": "가솔린", "trim": "1.6 터보 노블레스", "brand": "기아", "model": "K5 3세대", "region": "인천", "sell_type": "일반", "transmission": null }, "has_inspection": false }, "source_mode": "replica" }, { "id": "encar:43082202", "market": "kr", "source": "encar", "source_id": "43082202", "title": "2021 Genesis GV70 2.2 2WD", "brand": "Genesis", "model": "GV70", "generation": null, "trim": "2.2 2WD", "year": 2021, "mileage_km": 73374, "fuel": "diesel", "transmission": null, "engine_cc": null, "body_type": null, "color": null, "vin": null, "price": { "amount": "30900000.00", "currency": "KRW" }, "price_usd": "23009.85", "location": { "country": "KR", "region": "Gyeongnam", "city": null }, "photos": [ "https://api.apiauto.space/img/encar:43082202/1.jpg?exp=…&sig=…", "https://api.apiauto.space/img/encar:43082202/2.jpg?exp=…&sig=…" ], "photo_count": 4, "listing_url": "https://fem.encar.com/cars/detail/43082202", "is_active": true, "first_seen_at": "2026-11-03T02:17:42.264668Z", "last_seen_at": "2026-11-03T02:17:42.264668Z", "disappeared_at": null, "updated_at": "2026-11-03T02:17:42.264668Z", "raw": { "fx": { "date": "2026-11-02", "source": "ECB", "currency": "KRW", "usd_per_unit": "0.0007446554" }, "badge": "2.2 디젤 2WD", "trust": [], "has_vin": false, "condition": [ "Inspection", "Record" ], "form_year": "202109", "sell_type": "normal", "body_class": null, "office_city": "경남", "badge_detail": "(세부등급 없음)", "has_accident": false, "service_mark": [], "source_values": { "fuel": "디젤", "trim": "2.2 디젤 2WD (세부등급 없음)", "brand": "제네시스", "model": "GV70", "region": "경남", "sell_type": "일반", "transmission": null }, "has_inspection": false }, "source_mode": "replica" } ], "next_cursor": "…", "count": null } ``` Машины в ответах настоящие, из каталога на момент сборки сайта; фото сокращены до двух, id событий условные. ## Соберите запрос Выберите фильтры — адрес и код соберутся сами. Рынок закреплён: market=kr отдаёт только машины Encar. 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); ``` ## Сценарии 1. **Каталог на сайте импортёра** — 01 Каталог на сайте импортёраМашины Encar с фото и ценой в долларах на вашем сайте; раз в час подтягиваете новые и снятые по ленте изменений. Метод`GET /v1/cars · /v1/changes` 2. **Подбор под клиента** — 02 Подбор под клиентаМенеджер ищет по марке, году, пробегу и бюджету и отправляет клиенту фото и ссылку на объявление. Метод`GET /v1/cars?brand=…&year_min=…` 3. **Слежение за ценами** — 03 Слежение за ценамиЛента price_drop показывает, какие машины подешевели с прошлого опроса, с порогом в процентах. Метод`GET /v1/changes?type=price_drop` 4. **Telegram-бот подбора** — 04 Telegram-бот подбораБот сам присылает клиенту свежие машины по его фильтру: новые поступления приходят событием added. Метод`GET /v1/changes?type=added` ## Об источнике Что есть только у Encar, какие марки в каталоге и где проходят границы данных. ### Поля Encar в raw Всё, что есть только у Encar, лежит в объекте `raw` без изменений — ничего не выбрасываем. | Поле | Что значит | | --- | --- | | `sell_type` | Тип продажи: обычная продажа (normal), аренда или лизинг. У аренды и лизинга цена может быть не полной стоимостью. | | `has_accident`, `has_inspection`, `has_vin` | Флаги объявления, как их передаёт Encar. | | `condition`, `trust`, `service_mark` | Отметки Encar: доступные отчёты, гарантия, диагностика (например, EncarDiagnosisP1). | | `form_year` | Год и месяц в формате ГГГГММ, как у Encar. | | `badge`, `badge_detail` | Комплектация, как она записана на Encar, по-корейски. | | `office_city` | Город продавца по-корейски. | | `source_values` | Исходные написания марки, модели, комплектации, топлива и региона. | | `fx` | Курс, по которому посчитан `price_usd`: дата, источник (ECB), валюта. | ### Марки Encar в каталоге Самые частые марки каталога; параметр `brand` находит их в таком написании, регистр, пробелы и дефисы не важны. | Марка | Машин в каталоге | | --- | --- | | Hyundai | 34 863 | | Kia | 33 857 | | BMW | 12 643 | | Mercedes-Benz | 12 478 | | Genesis | 8 116 | | KGM (SsangYong) | 6 055 | | Chevrolet | 5 590 | | Renault Korea | 4 629 | | Audi | 3 158 | | Porsche | 2 595 | | Land Rover | 2 077 | | MINI | 1 972 | Полный список с числом машин — `GET /v1/references/brands?market=kr`, модели марки — `/v1/references/models`. Справочники бесплатны и квоту не тратят. ### Новые машины и изменения цен Лента `GET /v1/changes?market=kr&since=…` отдаёт события: новые машины (`added`), снятые с продажи (`disappeared`), снижение и рост цены (`price_drop`, `price_up`) с порогом в процентах. Так сайт или бот узнаёт о свежих поступлениях, не перечитывая весь каталог. Лента есть на тарифах Pro и Max и в демо; каждое событие — одна запись квоты. ### Границы данных Encar - VIN — примерно у 0,1 % машин; проверять историю по VIN для Кореи через API не получится. - Коробки передач и объёма двигателя в источнике нет. - Фото — обычно четыре, из поиска Encar. - У аренды и лизинга цена может быть не полной стоимостью — смотрите `raw.sell_type` . - Снятые с продажи машины остаются в API ещё 14 дней с `is_active=false` . - Возраст копии приходит в заголовке `X-Data-Age-Seconds` каждого ответа. ### Свой парсер Encar или API Свой парсер даёт полный контроль, но его приходится держать: блокировки, изменения сайта, перевод корейских названий, хранение фото. API снимает эту работу, но отдаёт только то, что есть в записи и в `raw`. [Парсер или готовый API — сравнение по пунктам](https://apiauto.space/parser-vs-api/). ## Частые вопросы ### 01Это официальный API Encar? Нет. apiauto.space не связан с Encar. Открытого API для сторонних разработчиков у Encar нет, поэтому данные обычно получают парсингом сайта. Мы держим копию каталога и отдаём её в едином формате через свой API. ### 02Нужен ли корейский прокси или IP? Нет. Запросы идут к нашему API, а не к Encar, и ключ работает из любой страны. Фото тоже отдаёт наш сервер. ### 03Как часто обновляются машины Encar? Копия Encar обновляется по расписанию, цель — каждый час. Возраст данных приходит в заголовке X-Data-Age-Seconds каждого ответа, текущая свежесть рынков — в /v1/references/markets. ### 04Есть ли данные на русском? Нет: марки и модели латиницей, значения полей — канонические английские, исходные корейские написания — в raw.source_values. Подписи для своих клиентов удобнее переводить у себя по словарю /v1/references/dictionaries. ### 05Можно ли показывать машины Encar на своём сайте? Да, в своём продукте и своим клиентам, включая фото. Перепродажа данных и полные выгрузки — только по договору Enterprise (оферта, п. 6). ### 06Сколько стоит API Encar? Тариф Start — $59 в месяц за один рынок, например только Корею: 100 000 машин в месяц. Квота считает возвращённые машины, а не запросы; справочники и фото бесплатны. Демо — сутки и 100 запросов без оплаты. ## Другие API и руководства - [API источника **API Che168**](https://apiauto.space/che168-api/) - [API источника **API Copart**](https://apiauto.space/copart-api/) - [API источника **API IAAI**](https://apiauto.space/iaai-api/) - [Руководство **Каталог авто на сайт импортёра**](https://apiauto.space/importers/) - [Разработчикам **Документация**](https://apiauto.space/docs/) ## Получите тестовый ключ Encar - Сутки и 100 запросов бесплатно, без карты - Все три рынка и лента изменений: Корею можно сравнить с Китаем и США - Ключ приходит в Telegram за минуту — без формы и звонков --- Страница: https://apiauto.space/encar-api/