DocumentaciónReferencia API
Documentación de API Scraper automotriz. Aprenda cómo acceder a datos de autos con integración REST. Guías de integración y ejemplos de código.
Datos automotrices limpios y estructurados entregados mediante API. Sin configuración compleja, gestión de infraestructura o mantenimiento técnico necesario.
Por Qué Elegirnos
Experiencia en la Industria
Proveedor de API de datos automotrices con más de 8 años de experiencia desde 2017.
Soporte 7 Días
Equipo de soporte disponible 7 días a la semana para ayuda con integración de API.
Servicio 24/7
Monitoreo continuo para entrega confiable de datos.
Capacidades clave de la API | Scrapers y Parsers
Alertas de anuncios en tiempo real
Obtenga acceso API instantáneo a nuevos anuncios de autos cuando se publican.
Exportaciones diarias de datos
Obtenga exportaciones diarias de anuncios activos y retirados para análisis de mercado y seguimiento de ventas.
Formatos de exportación flexibles
Obtenga datos en CSV, JSON, Excel y formatos personalizados para fácil integración.
Preguntas frecuentes | API vs Scraper y Crawler
¿Cómo funciona la API automotriz?
La API automotriz proporciona acceso en tiempo real a datos de los principales marketplaces de autos. Entrega datos formateados mediante REST API.
¿Qué datos proporciona la API automotriz?
Datos completos de autos incluyendo especificaciones, precios, información del vendedor, ubicación y kilometraje. Accede a millones de anuncios de las principales plataformas mediante llamadas API.
¿Hay límites de uso?
Sin límites de uso. Obtenga todos los anuncios activos en todas las regiones vía API en tiempo real o exportaciones diarias. Sin restricciones para socios comerciales.
¿Cómo puedo rastrear nuevos anuncios de autos con la API en tiempo real?
Monitoree anuncios usando el parámetro 'change_id'. Comience con change_id=0, luego use el último ID de cambio + 1. Rastree nuevos anuncios, cambios de precio y bajas en todas las plataformas.
¿Qué formatos de datos soportan?
Obtenga datos en CSV, JSON, Excel y formatos de base de datos. Cada formato proporciona datos completos de todas las plataformas.
¿Pueden construir acceso API personalizado para un marketplace específico?
Sí, construimos soluciones API personalizadas para cualquier marketplace de autos. Contáctenos con sus requisitos.
¿Se mantiene confidencial mi uso de datos?
Sí. Trabajamos bajo estrictos acuerdos de confidencialidad con todos los clientes. Su uso de nuestros servicios permanece privado y seguro.
¿Necesito gestionar infraestructura o servidores?
No, está completamente gestionado. Manejamos toda la infraestructura, servidores y recolección de datos. Obtiene datos listos para usar.
URL base
https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}Autorización: api_key parameter
Flujo de trabajo
/filtersobtener valores de filtro disponibles/offersobtener anuncios (con o sin filtros) - usar para carga inicial de datosPara actualizaciones (mantener datos actualizados después de la carga inicial):
/change_id?date=...obtener ID inicial para el feed de cambios/changes?change_id=...obtener todos los cambios en la base de datos desde el ID/offerobtener detalles de un anuncio específico por inner_idEnfoque de integración recomendado:
1. Primero, use /offers para la recuperación inicial de datos (recorra todas las páginas)
2. Luego, use /changes para la recuperación periódica de todos los cambios (agregados/modificados/eliminados) para sincronizar su base de datos local con la fuente
3. Para la integración de datos en el sitio web, puede usar /offers con filtros y paginación (marca, modelo, precio, año, etc.)
GET/filters
Devuelve todos los valores posibles para filtrado
https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEYRespuesta:
{
"mark": {
"Hyundai": {
"model": {
"Sonata": {
"configuration": {
"DN8": { "complectation": ["Smart", "Modern", "Premium"] }
}
}
}
},
"Kia": {
"model": {
"K5": {
"configuration": {
"DL3": { "complectation": ["LX", "EX", "SX"] }
}
}
}
}
},
"transmission_type": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
"color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
"body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
"engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}GET/offers
Lista de anuncios con paginación y filtros
Parámetros:
page(requerido) - número de páginamark, model, configuration, complectation- filters (no distingue mayúsculas)transmission_type, color, body_type, engine_type- filters (no distingue mayúsculas)year_from, year_to- filtro de rango de añoskm_age_from, km_age_to- filtro de rango de kilometrajeprice_from, price_to- filtro de rango de precios (en unidades de 10.000 KRW)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=blackRespuesta:
{
"result": [
{
"id": 3219435,
"inner_id": "40427050",
"change_type": "added",
"created_at": "2025-09-08T12:02:03.000Z",
"data": {
"id": 1454012,
"inner_id": "40427050",
"url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
"mark": "Hyundai",
"model": "Palisade",
"generation": "Diesel 2.2 4WD",
"configuration": "Diesel 2.2 4WD",
"complectation": "Prestige",
"year": 2021,
"color": "Black",
"price": 3190,
"price_won": "31900000",
"km_age": 92842,
"engine_type": "Diesel",
"transmission_type": "Automatic",
"body_type": "SUV",
"address": "Busan Gijang-gun",
"seller_type": "DEALER",
"is_dealer": true,
"images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
"extra": {"diagnosis": {...}, "inspection": {...}, "record_open": {...}}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Campos de datos:
- id - ID interno de base de datos
- inner_id - ID del anuncio en la plataforma
- url - enlace al anuncio
- mark - marca del auto
- model - modelo del auto
- generation - generación
- configuration - configuración
- complectation - equipamiento/versión
- year - año de producción
- color - color
- price - precio (en unidades de 10.000 KRW)
- price_won - precio completo en KRW
- km_age - kilometraje en km
- engine_type - tipo de motor
- transmission_type - tipo de transmisión
- body_type - tipo de carrocería
- address - dirección
- seller_type - tipo de vendedor
- is_dealer - indicador de concesionario (true/false)
- section - sección
- seller - vendedor
- salon_id - ID del concesionario
- description - descripción
- displacement - cilindrada del motor (cc)
- offer_created - fecha de creación del anuncio
- images - array de URLs de imágenes
- extra - diagnóstico, informe de inspección e historial del seguro
- diagnosis - diagnóstico de Encar de los paneles de la carrocería
- inspection - informe de inspección, incluido el diagrama de daños de la carrocería en extra.inspection.outers como lista de piezas con sus anotaciones
- record_open - historial del seguro, incluidos los siniestros y sus indemnizaciones en extra.record_open.accidents
- options - lista de opciones
GET/change_id
Obtener primer ID de cambio por fecha (para usar en /changes)
Parámetros:
date(requerido) - fecha en formato yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15Respuesta:
{ "change_id": 1547283 }Use el valor devuelto como parámetro change_id en /changes
GET/changes
Feed de cambios (añadido/cambiado/eliminado)
Parámetros:
change_id(requerido) - a partir de qué ID de cambio
https://{access_name}.auto-api.com/api/v2/{platform}/changes?api_key=YOUR_API_KEY&change_id=1Respuesta:
{
"result": [
{
"id": 456,
"inner_id": "40427050",
"change_type": "added", // added - new listing
"created_at": "2025-01-15T10:30:00Z",
"data": { ... } // full listing data
},
{
"id": 457,
"inner_id": "40427051",
"change_type": "changed", // changed - price update
"created_at": "2025-01-15T10:31:00Z",
"data": { "new_price": 3490 }
},
{
"id": 458,
"inner_id": "40427052",
"change_type": "removed", // removed - listing deleted
"created_at": "2025-01-15T10:32:00Z"
}
],
"meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}GET/offer
Anuncio individual por inner_id
Parámetros:
inner_id(requerido)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050Respuesta: objeto data (igual que en /offers, pero sin envoltorio result)
Recupere los datos completos del anuncio proporcionando la URL original de cualquier plataforma compatible. Ideal para busquedas rápidas y recuperación de un solo anuncio.
URL base
https://{access_name}.auto-api.com/api/v1/offer/infoAutorización mediante el encabezado x-api-key
POST/api/v1/offer/info
Envíe una solicitud POST con la URL del anuncio para obtener los datos completos
Parámetros:
url(requerido) - enlace al anuncio en cualquier plataforma compatible
Ejemplo de solicitud:
curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'Respuesta:
{
"inner_id": "39225419",
"url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
"mark": "BMW",
"model": "5-Series",
"generation": "528i",
"year": 2010,
"year_month": "2010-08",
"color": "Silver",
"price": 880,
"price_won": 8800000,
"km_age": 132437,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "Sedan",
"displacement": "2996",
"power": "230",
"vin": "WBAFR1105AC258998",
"address": "Gwangju Seo-gu",
"seller_type": "DEALER",
"is_dealer": true,
"offer_created": "2025-11-17",
"images": [
"https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
"https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
]
}Campos de datos:
- inner_id - ID del anuncio en la plataforma
- url - enlace al anuncio
- mark - marca del auto
- model - modelo del auto
- generation - generación
- year - año de producción
- year_month - año y mes de producción
- color - color
- price - precio en unidades de 10000 KRW
- km_age - kilometraje en km
- engine_type - tipo de motor
- transmission_type - tipo de transmisión
- body_type - tipo de carrocería
- displacement - cilindrada del motor (cc)
- power - potencia en hp
- vin - código VIN
- address - dirección
- seller_type - tipo de vendedor
- is_dealer - indicador de concesionario (true/false)
- offer_created - fecha de creación del anuncio
- images - array de URLs de imágenes
Política de retención de datos
Archivos almacenados por un mínimo de 3 días
Horario de disponibilidad de la API
Archivos diarios actualizados disponibles para descarga
Formato de datos CSV
Archivos CSV usan pipe (|) como separador de columnas
Estructura de URL:
Parámetros de solicitud:
access_name- su identificador de subdominio asignadodate- fecha objetivo en formato aaaa-mm-dd (ej., 2025-09-06)file_name- nombre del archivo de exportación con extensión
Formatos disponibles:
- CSV - all_active.csv, new_daily.csv, removed_daily.csv
- JSON - all_active.json, new_daily.json, removed_daily.json
- Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx
Ejemplo de solicitud API cURL
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvComando de descarga Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'