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 listados en tiempo real

Obtenga acceso API instantáneo a nuevos listados de autos cuando se publican.

Exportaciones diarias de datos

Obtenga exportaciones diarias de listados 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 listados de las principales plataformas mediante llamadas API.

¿Hay límites de uso?

Sin límites de uso. Obtenga todos los listados activos en todas las regiones vía API en tiempo real o exportaciones diarias. Sin restricciones para socios comerciales.

¿Cómo puedo rastrear nuevos listados de autos con la API en tiempo real?

Monitoree listados usando el parámetro 'change_id'. Comience con change_id=0, luego use el último ID de cambio + 1. Rastree nuevos listados, 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.

API Reference

URL base

https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}

Autorización: api_key parameter

Flujo de trabajo

1
/filtersobtener valores de filtro disponibles
2
/offersobtener listados (con o sin filtros) - usar para carga inicial de datos
3

Para 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
4
/offerobtener detalles de un listado específico por inner_id

Enfoque 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_KEY

Respuesta:

{
  "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 listados con paginación y filtros

Parámetros:

  • page (requerido) - número de página
  • mark, 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ños
  • km_age_from, km_age_to - filtro de rango de kilometraje
  • price_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=black

Respuesta:

{
  "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": {...}, "accidents": [...]}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Campos de datos:

  • id - ID interno de base de datos
  • inner_id - ID del listado en la plataforma
  • url - enlace al listado
  • 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 listado
  • images - array de URLs de imágenes
  • extra - datos adicionales (JSON)
  • 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-15

Respuesta:

{ "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=1

Respuesta:

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

Listado 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=40427050

Respuesta: objeto data (igual que en /offers, pero sin envoltorio result)

Obtener anuncio por URL

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/info

Autorizació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 listado en la plataforma
  • url - enlace al listado
  • 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 listado
  • images - array de URLs de imágenes
Exportaciones Diarias

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:

https://{access_name}.auto-api.com/{date}/{file_name}

Parámetros de solicitud:

  • access_name - su identificador de subdominio asignado
  • date - 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.csv

Comando de descarga Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'