Documentación
Documentación de EnCarAPI. Aprende a acceder a datos de coches coreanos mediante endpoints API directos. Guías de integración y ejemplos de código.
Experiencia en el sector
Proveedor de API de datos automotrices con años de experiencia en el mercado coreano.
Soporte 7 días
Equipo de soporte disponible los 7 días de la semana para ayuda con la integración API.
Servicio 24/7
Monitoreo continuo para una entrega de datos fiable.
Alertas de listados en tiempo real
Obtén acceso API instantáneo a nuevos listados de coches en cuanto se publican.
Descargas CSV
Descarga las listas de marcas, modelos y versiones en CSV - guárdalas en caché y evita las llamadas de facetas en vivo.
Formatos de exportación flexibles
Obtén datos en CSV, JSON, Excel y formatos personalizados para una fácil integración.
URL base
Todas las solicitudes API se realizan a la siguiente URL base:
https://api.encarapi.comPor ejemplo, para obtener ofertas:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=trueAutenticació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_KEYFlujo de trabajo de integración
Sigue estos cuatro pasos para integrarte con EnCarAPI.
Obtener filtros disponibles
Recupera todos los valores de filtro posibles (marcas, modelos, configuraciones, colores, etc.)
GET /filtersObtener listados de vehículos
Obtén listados paginados con filtros opcionales por marca, modelo, año, precio y más.
GET /offers?page=1Rastrear cambios
Obtén un ID de cambio para una fecha, luego consulta los listados añadidos, modificados y eliminados.
GET /change_id → GET /changesObtener detalles del listado
Obtén los detalles completos de un listado específico por su inner_id.
GET /offer?inner_id=...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).
Descárgalos una vez y guárdalos en caché - Actualizado a diario
Todas las marcas con recuentos de anuncios
Todas las combinaciones de marca y modelo con recuentos
Todos los valores de marca, modelo y versión (incl. Coupe / Sedán / Cabrio) con recuentos
Añade tu clave API para descargar - agrega ?api_key=YOUR_KEY a la URL del archivo. Los archivos están protegidos con clave, nadie puede descargarlos sin una clave válida.
Actualidad de los datos
El catálogo (precios, kilometraje, anuncios nuevos y vendidos) se actualiza aproximadamente cada 5 horas, con una pasada más profunda una vez al día. El detalle del vehículo (especificaciones, fotos, estado, informe de accidentes) sigue su propio ciclo, más lento - normalmente dentro de las 3 semanas siguientes a un cambio, antes si el catálogo indica algo relevante.
Alcance del catálogo
GET /api/catalog abarca únicamente los anuncios de venta estándar (tipo de venta “일반” de Encar). Los traspasos de leasing (“리스”) y los alquileres (“렌트”) no se mezclan - se cotizan por cuota mensual en lugar de por precio de compra, lo que distorsionaría el campo Price. Usa GET /api/catalog/leasing para esos anuncios.
Cuánto tiempo cachear
- Valores de filtro, CSV de taxonomía y /api/nav: cachea durante 24 horas
- Anuncios de vehículos (/api/catalog): cachea durante 4 a 6 horas
- Detalles del vehículo (/api/vehicle/:id): cachea durante 24 horas
Este es el modelo Starter: sirve los anuncios desde tu propia base de datos y actualízalos con esta frecuencia en lugar de llamar en vivo en cada clic del usuario. Este plan tiene un límite diario de volumen de catálogo - está pensado para consultas en vivo, no para mantener una copia local completa.
¿Necesitas una copia local completa?
Los planes Business y Scale incluyen GET /api/catalog/export (una instantánea CSV completa diaria que no cuenta para el límite diario) y GET /api/catalog/changes?since=... (anuncios añadidos, actualizados, reaparecidos y eliminados desde tu última sincronización). Carga tu base de datos una vez a partir de la exportación y después consulta los cambios para mantenerla al día - sin volver a descargar el catálogo completo. Scale además elimina por completo el límite diario de volumen de catálogo.
Anuncios duplicados
Los concesionarios coreanos suelen publicar el mismo coche físico dos veces con IDs de anuncio distintos para ganar visibilidad - mismo precio, kilometraje, año-modelo y modelo/acabado. Detectamos estos casos y marcamos las copias adicionales con IsDuplicate: true y DuplicateOf: <ID del anuncio original> en el elemento del catálogo; el anuncio original queda sin marcar. Los duplicados se marcan, no se eliminan, para que decidas cómo tratarlos - pasa exclude_duplicates=true a /api/catalog o /api/catalog/leasing para filtrarlos en el servidor.
Preguntas frecuentes
¿Listo para empezar?
Contáctanos en Telegram para obtener tus credenciales API y comienza a acceder a datos de coches coreanos hoy.