API de Anuncios de Autos para Encar, Mobile.de, Che168, Dongchedi y Más

EncarMobile.deAutoScout24Che168GuaziDongchedi+9 más

Acceda a datos de anuncios de vehículos en tiempo real y agregados diariamente a través de una API única y confiable. Monitoree nuevos anuncios, cambios de precio, publicaciones y eliminaciones en tiempo real en múltiples plataformas.

Probar API ahoraVer documentaciónAcceso proporcionado en 2 minutos
100M+
anuncios
15+
plataformas
50+
campos de datos
Tiempo de respuesta<200ms
Estado de API
operativo
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'
Funciones de la API

Datos multi-plataforma

Acceda a millones de listados de Encar, Mobile.de, AutoScout24 y más mercados desde una única integración API.

Actualizaciones en tiempo real

Reciba nuevos anuncios, cambios de precios y eliminaciones en el momento en que ocurren.

Análisis de mercado

Datos históricos completos y tendencias del mercado para análisis predictivo de precios y decisiones estratégicas.

Entrega flexible

Elija entre acceso API en tiempo real o exportaciones masivas diarias en CSV, JSON, Excel.

Mercados globales

Cobertura en Europa, Asia, Medio Oriente y América del Norte.

Integración simple

API RESTful con documentación y ejemplos de código funcionales.