Documentación

URL base

Todas las solicitudes API se realizan a la siguiente URL base:

https://api.encarapi.com

Por ejemplo, para obtener ofertas:

GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true

Autenticación

Autentica tus solicitudes usando una clave API. Pásala como parámetro de consulta o mediante el encabezado Authorization.

# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"

# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEY

Prueba de 5 días

Prueba la API durante 5 días con los tres marketplaces (Encar, KB Chachacha, K Car), incluida la sincronización de cambios (últimos 7 días), las consultas masivas (1.000 ids al día) y una vista previa del archivo (100 anuncios eliminados al día). 100.000 filas de catálogo y 2.000 consultas de detalle en total (máx. 1.000 al día). Las descargas de referencia (CSV) forman parte de los planes de pago. La exportación completa del catálogo empieza con Business. Después de la prueba, tu suscripción continúa en el plan Starter a 149 €/mes - cancelable en cualquier momento antes del día 5.

Valores en ruso (lang=ru)

Todo endpoint que acepta lang=en acepta también lang=ru: los valores de visualización llegan en ruso y todo lo demás no cambia (ids, códigos, precios, números, nombres de campos). Un valor sin etiqueta rusa vuelve al inglés. Las etiquetas rusas pueden mejorarse con el tiempo, así que vincula tus datos por ids y códigos, no por etiquetas.

• Se traducen: combustible, transmisión, tracción, color exterior e interior, tipo de carrocería, tipo de venta, nombres de regiones y ciudades, nombres de opciones y las palabras genéricas de las versiones (Diesel -> дизель, 7-Seater -> 7 мест). Generaciones de modelo: Carnival 4 Gen -> Carnival 4 поколение. Las marcas, modelos y versiones se mantienen en alfabeto latino, como en los portales de coches rusos.
• Los filtros aceptan también los valores en ruso: fuel=дизель, color=белый, region=Сеул, city=Сувон, drivetrain=полный, sell_type=лизинг. Los valores en inglés siguen funcionando.
• /api/enums?lang=ru añade nameRu a cada valor y lista los valores de drivetrain y sell_type. /api/nav?lang=ru devuelve un DisplayValue en ruso; Value sigue siendo el código inglés para filtrar. Con lang=ru, los CSV de referencia reciben el nombre ruso como columna adicional después de la última.
• /api/vehicle/{id}?lang=ru y el endpoint bulk devuelven en ruso los valores spec de Encar, los nombres de category y los nombres de optionsDecoded, y los anuncios de KB Chachacha como en el catálogo.
• /api/catalog/export?lang=ru es el mismo archivo con las columnas de etiquetas en ruso; el orden de columnas y todas las demás columnas no cambian.
• No se traducen: informes de inspección, historiales de seguro, diagnósticos de Encar, historiales de vehículo de Encar, datos de detalle de K Car, paquetes de opciones de Encar (texto libre del anuncio) y los endpoints de camiones y excavadoras (con lang=ru responden en inglés).

# Russian values, filtered with Russian values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?fuel=дизель&city=Сувон&lang=ru&count=true"

# Filter values with their Russian labels (nameRu)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/enums?lang=ru"

Valores en alemán (lang=de)

lang=de funciona como lang=ru: los valores de visualización llegan en alemán y todo lo demás no cambia (ids, códigos, precios, números, nombres de campos). Un valor sin etiqueta alemana vuelve al inglés.

• Se traducen: combustible, transmisión, tracción, colores, tipo de carrocería, tipo de venta, nombres de opciones y los nombres de modelos y versiones de nuestras tablas alemanas (C-Class -> C-Klasse, 5-Series -> 5er, Carnival 4 Gen -> Carnival 4. Generation, 7-Seater -> 7-Sitzer, Sedan -> Limousine). Las regiones usan el nombre inglés y las ciudades se mantienen en inglés.
• Los filtros aceptan también los valores en alemán: fuel=Benzin, color=Weiß, transmission=Automatik, drivetrain=Allrad, sell_type=Leasingübernahme, model_group=C-Klasse. Los nombres de modelo alemanes pueden agrupar restylings: Carnival 4. Generation abarca Carnival 4 Gen y The New Carnival 4 Gen.
• Listas, detalle, bulk y export funcionan como con lang=ru: nameDe en /api/enums y /api/taxonomy/option-packages, un DisplayValue en alemán en /api/nav, columnas *_de en los CSV de referencia, catalog_export_de.csv para el export. No se traduce lo mismo que con lang=ru.

# German values, filtered with German values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=Mercedes-Benz&model_group=C-Klasse&fuel=Benzin&lang=de&count=true"

Tres marketplaces, una API

La API ofrece anuncios en vivo de los tres principales marketplaces de coches usados de Corea. Todos los endpoints devuelven Encar por defecto, por lo que las integraciones existentes siguen funcionando sin cambios. Los otros dos se activan mediante el parámetro source.

Selección de fuentes

source se acepta en /api/catalog, /api/nav, /api/enums, /api/model-search, /api/catalog/export, /api/catalog/changes y los CSV de taxonomía.

# All three marketplaces, English values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=all&manufacturer=bmw&fuel=diesel&lang=en&count=true"

# K Car only
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=kcar&manufacturer=hyundai&lang=en"

# One KB Chachacha vehicle
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/vehicle/kbc:12345678?lang=en"

Cuando se indica source, cada elemento incluye un campo Source. Los ids de Encar siguen siendo números simples. Los ids de KB Chachacha y K Car llevan un prefijo (kbc:..., kcar:...) - páselos sin cambios a /api/vehicle/{id}. Con lang=en, los nombres de modelo y de acabado de los tres marketplaces se devuelven en inglés.

Los concesionarios suelen publicar el mismo coche en Encar y KB Chachacha. Un anuncio de KB Chachacha se asocia a un anuncio activo de Encar por la matrícula coreana o, cuando KB Chachacha no publica la matrícula, por el mes de primera matriculación, el kilometraje y el precio; la asociación se recalcula varias veces al día, tras cada pasada del catálogo de Encar y de KB Chachacha. Los anuncios de KB Chachacha asociados no los devuelven /api/catalog, /api/catalog/export ni los demás endpoints del catálogo, con o sin source (tampoco con source=kbc solo), así que el mismo coche nunca aparece dos veces - si Encar está incluido, se devuelve como el anuncio de Encar.

En /api/catalog/changes?source=kbc y /api/vehicle/kbc:{id} estos anuncios llevan IsDuplicate: true y DuplicateOf (el ID del anuncio de Encar, como cadena numérica); igual que en los elementos de Encar, ambos campos solo aparecen cuando son true. Cuando la marca se activa o se retira, el feed de cambios registra un evento updated cuyo changedFields contiene duplicate. Para mantener una copia local coherente con /api/catalog, elimina los elementos de KB Chachacha que llegan con IsDuplicate: true y vuelve a añadirlos cuando llegue una actualización sin ese campo.

El feed de cambios acepta una fuente por llamada (encar, kbc o kcar) y mantiene un cursor independiente para cada una.

Cobertura por marketplace

No todos los marketplaces publican todos los campos.

• KB Chachacha publica el número de asientos en una parte de sus anuncios.
• Detalle de KB Chachacha = el elemento del catálogo más el bloque de historial público (indicador de accidente, siniestro total, inundación, uso comercial, gravámenes, diagnóstico de chasis y paneles). Cada elemento de KB Chachacha incluye además InsuranceClaims: el número de siniestros de seguro que muestra la página del anuncio. El detalle también incluye InspectionReportUrl e InspectionReportType: la hoja de inspección que KB Chachacha muestra para el coche (link = informe en el sitio web de la empresa de inspección, scan = solo imágenes escaneadas en la página del anuncio, null = aún desconocida). Cuando InspectionAvailable es true, GET /api/inspection/kbc:{id} devuelve esa hoja como datos estructurados en el mismo formato que un informe de inspección de Encar (master, outers, inners, images), además de un bloque source - en aproximadamente dos de cada cinco anuncios de KB Chachacha con una hoja enlazada.
• K Car no tiene documentos de informe separados; el número de accidentes, los pagos del seguro y los cambios de titularidad forman parte del detalle del vehículo.

Filtrar por un campo que un marketplace no proporciona excluye de los resultados los vehículos de ese marketplace. Ejemplo: frame_clean=true con source=all devuelve solo anuncios de Encar y K Car.

Endpoints API

Todos los endpoints disponibles para acceder a datos de vehículos coreanos.

Datos de los desplegables (CSV)

Descarga las listas de marcas, modelos y versiones en CSV, guárdalas en caché y crea tus desplegables a partir de ellas - sin llamadas de facetas por cada clic ni mapeo sin conexión. Cada archivo incluye una columna de recuento, y el archivo de versiones contiene el desglose por carrocería (Coupe / Sedán / Cabrio).

Preguntas frecuentes