API источника · Encar · Южная Корея

API Encar для авто из Кореи — в JSON, без своего парсера

Encar — крупнейшая площадка подержанных авто Южной Кореи: дилеры и частные продавцы выставляют машины по фиксированной цене. apiauto.space отдаёт каждое объявление Encar в той же записи, что у Che168, Copart и IAAI: цена в вонах и долларах, пробег, фото, регион и все поля источника. Ключ работает из любой страны — корейский прокси не нужен.

Получить тестовый ключ Документация

Источник: encar.com · market=kr
Регион: Южная Корея
Данные: Объявления, цены, фото, изменения
Статус: Работает · обновление каждый час

Что содержит запись Encar

Одни и те же ключи у всех рынков; справа — значения настоящей машины из каталога. Чего Encar не даёт, приходит как null, а не догадка.

Машина

titleГод, марка, модель и комплектация одной строкой"2021 BMW 7 Series (G11) 740Li xD…
brandЛатиницей, одинаково во всех рынках"BMW"
modelСемейство модели, как на других рынках"7 Series"
trimКомплектация в латинице"740Li xDrive Design Pure Excelle…
yearГод выпуска2021
mileage_kmПробег в километрах179132
fuelКаноническое английское значение"gasoline"

Цена

priceЦена в вонах, как на Encar34900000.00 KRW
price_usdТа же цена в долларах"25988.47"
raw.fx.usd_per_unitДневной курс ЕЦБ, по которому посчитано"0.0007446554"

Место и фото

location.regionРегион продавца"Gyeonggi"
photo_countОбычно 4 фото из поиска Encar4
photos.0Подписанная ссылка, живёт около суток"api.apiauto.space/img/encar:4307…
listing_urlОбъявление на encar.com"fem.encar.com/cars/detail/430791…

Статус

is_activeВ продаже сейчасtrue
first_seen_atКогда машина появилась в каталоге, UTC"2026-11-02T14:34:16.763020Z"
disappeared_atСнятые с продажи остаются 14 днейnull

Только у Encar · raw

raw.sell_typeПродажа, аренда или лизинг"normal"
raw.has_accidentФлаг ДТП, как его передаёт Encarfalse
raw.conditionДоступные отчёты Encar["Record"]
raw.form_yearГод и месяц, ГГГГММ"202101"
raw.source_values.brandИсходное корейское написание"BMW"

Encar не даёт

vinVIN есть примерно у одной машины из тысячиnull
transmissionКоробки передач в каталоге нетnull
engine_ccОбъёма двигателя тожеnull

encar:43079113 2021 BMW 7 Series (G11) 740Li xDrive Design Pure Excellence · 179 132 км

Запрос и ответ

Четыре запроса, с которых обычно начинают. Ключ — в заголовке X-API-Key, ответ — JSON.

Страница машин по фильтрам и курсор следующей

GEThttps://api.apiauto.space/v1/cars?market=kr&limit=2

cURL

curl -s "https://api.apiauto.space/v1/cars?market=kr&limit=2" \
  -H "X-API-Key: $APIAUTO_KEY"

JavaScript

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

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
$ch = curl_init("https://api.apiauto.space/v1/cars?market=kr&limit=2");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 OK · пример ответа

{
  "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
}

Машины в ответах настоящие, из каталога на момент сборки сайта; фото сокращены до двух, id событий условные.

Соберите запрос

Выберите фильтры — адрес и код соберутся сами. Рынок закреплён: market=kr отдаёт только машины Encar.

GEThttps://api.apiauto.space/v1/cars?market=kr&brand=Hyundai&limit=20

cURL

curl -s "https://api.apiauto.space/v1/cars?market=kr&brand=Hyundai&limit=20" \
  -H "X-API-Key: $APIAUTO_KEY"

JavaScript

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

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
$ch = curl_init("https://api.apiauto.space/v1/cars?market=kr&brand=Hyundai&limit=20");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Сценарии

01
Каталог на сайте импортёра
Машины Encar с фото и ценой в долларах на вашем сайте; раз в час подтягиваете новые и снятые по ленте изменений.
МетодGET /v1/cars · /v1/changes
02
Подбор под клиента
Менеджер ищет по марке, году, пробегу и бюджету и отправляет клиенту фото и ссылку на объявление.
МетодGET /v1/cars?brand=…&year_min=…
03
Слежение за ценами
Лента price_drop показывает, какие машины подешевели с прошлого опроса, с порогом в процентах.
МетодGET /v1/changes?type=price_drop
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 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

Полный список с числом машин — 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 — сравнение по пунктам.

Частые вопросы

Это официальный API Encar?

Нет. apiauto.space не связан с Encar. Открытого API для сторонних разработчиков у Encar нет, поэтому данные обычно получают парсингом сайта. Мы держим копию каталога и отдаём её в едином формате через свой API.

Нужен ли корейский прокси или IP?

Нет. Запросы идут к нашему API, а не к Encar, и ключ работает из любой страны. Фото тоже отдаёт наш сервер.

Как часто обновляются машины Encar?

Копия Encar обновляется по расписанию, цель — каждый час. Возраст данных приходит в заголовке X-Data-Age-Seconds каждого ответа, текущая свежесть рынков — в /v1/references/markets.

Есть ли данные на русском?

Нет: марки и модели латиницей, значения полей — канонические английские, исходные корейские написания — в raw.source_values. Подписи для своих клиентов удобнее переводить у себя по словарю /v1/references/dictionaries.

Можно ли показывать машины Encar на своём сайте?

Да, в своём продукте и своим клиентам, включая фото. Перепродажа данных и полные выгрузки — только по договору Enterprise (оферта, п. 6).

Сколько стоит API Encar?

Тариф Start — $59 в месяц за один рынок, например только Корею: 100 000 машин в месяц. Квота считает возвращённые машины, а не запросы; справочники и фото бесплатны. Демо — сутки и 100 запросов без оплаты.

Другие API и руководства

Получите тестовый ключ Encar

Сутки и 100 запросов бесплатно, без карты
Все три рынка и лента изменений: Корею можно сравнить с Китаем и США
Ключ приходит в Telegram за минуту — без формы и звонков

Получить тестовый ключ Telegram

apiauto.spaceботпечатает

Сегодня

/start demo12:04

Демо открыто до 04.11.2026 12:04 UTC.
100 запросов за данными, до 20 машин за раз, все три рынка и лента изменений. Справочники, расход и фото бесплатны.

Ключ — следующим сообщением. Он показывается один раз: сохраните его.12:04

au_live_••••••••••••••••••••••••••••••••12:04

Сообщение

Так ключ приходит в боте; здесь он скрыт.