AUTO-API.COM
Logo Guazi

Guazi APIScraper & Parser

API de Guazi para datos del mercado de autos usados de China. Listados, precios y especificaciones de vehículos de segunda mano.

API Guazi

Acceso al mercado de autos usados chino. Datos estructurados de Guazi para análisis y decisiones.

Tiempo Real

Listados de usados al momento.

Exportaciones

Listados actuales.

Data API

Precio, Kilometraje, Estado, Historial, Especificaciones del vehículo usado.

Obtener AccesoAcceso proporcionado en 2 minutos

URL base

https://{access_name}.auto-api.com/api/v2/guazi

Autorización: api_key parámetro

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

Cómo integrar efectivamente:

1. Primero, use /offers para recuperar todo el conjunto de datos (pagine a través de todos los resultados)

2. Luego, consulte /changes periódicamente para obtener todas las actualizaciones (registros nuevos/actualizados/eliminados) para sincronizar su base de datos local con la fuente

3. Para integración front-end, use /offers con filtros específicos y paginación (marca, modelo, rango de precio, año, etc.)

GET/filters

Devuelve todos los valores posibles para filtrado

https://{access_name}.auto-api.com/api/v2/guazi/filters?api_key=YOUR_API_KEY

Respuesta:

{
  "mark": {
    "BMW": { "model": ["X5", "X3"] },
    "Audi": { "model": ["A4", "Q7"] }
  },
  "transmission_type": ["MT", "AT"],
  "color": ["Green", "Purple", "Red", "White", "Champagne", "Silver", "Black", "Gray", "Blue", "Yellow"],
  "rudder": ["Left"],
  "body_type": ["Sedan", "Station Wagon", "SUV", "Convertible", "Bus", "Sports Car", "Hatchback", "Pick Up", "Crossover", "Truck"],
  "engine_type": ["Diesel", "PHEV", "HEV", "Gasoline", "BEV", "REEV"],
  "drive_type": ["4WD", "2WD"]
}

GET/offers

Lista de listados con paginación y filtros

Parámetros:

  • page (requerido) - número de página
  • mark, model, transmission_type, color, rudder, body_type, engine_type, drive_type - filtros (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 CNY)
https://{access_name}.auto-api.com/api/v2/guazi/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/guazi/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&color=black

Respuesta:

{
  "result": [
    {
      "id": 3847521,
      "inner_id": "152471636",
      "change_type": "added",
      "created_at": "2025-10-28T14:28:35.620Z",
      "data": {
        "id": 5269,
        "inner_id": "152471636",
        "url": "https://www.guazi.com/binzhou/auto/152471636.htm",
        "title": "Haval H2 2016 1.5T AT",
        "mark": "Haval",
        "model": "H2",
        "full_model": "H2 1.5T Automatic Elite",
        "transmission_type": "AT",
        "year": 2016,
        "km_age": 112700,
        "price": 5011,
        "color": "Black",
        "displacement": 1.5,
        "doors_count": 5,
        "region": "China",
        "city": "Binzhou",
        "address": "Binzhou, Shandong",
        "section": "used",
        "rudder": "Left",
        "body_type": "SUV",
        "engine_type": "Gasoline",
        "equipment": ["Heated Seats", "Keyless Entry", "Backup Camera"],
        "images": ["https://global-image-pub.guazistatic.com/qnbdp7206x..."],
        "extra": {"inspection_score": 85},
        "drive_type": "2WD",
        "productionYearMonth": "2016-03",
        "licenseDate": "2016-05-20"
      }
    }
  ],
  "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
  • title - título del listado
  • mark - marca del auto
  • model - modelo del auto
  • full_model - nombre completo del modelo
  • transmission_type - tipo de transmisión (AT/MT)
  • year - año de producción
  • km_age - kilometraje en km
  • price - precio en CNY
  • color - color
  • displacement - cilindrada del motor
  • doors_count - número de puertas
  • region - región
  • city - ciudad
  • address - dirección
  • section - sección
  • rudder - posición del volante (izquierda/derecha)
  • body_type - tipo de carrocería
  • engine_type - tipo de motor
  • equipment - lista de equipamiento
  • images - array de URLs de imágenes
  • drive_type - tipo de tracción (FWD/RWD/AWD)
  • productionYearMonth - fecha de producción (año-mes)
  • licenseDate - fecha de registro

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/guazi/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Respuesta:

{ "change_id": 6718293 }

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/guazi/changes?api_key=YOUR_API_KEY&change_id=1

Respuesta:

{
  "result": [
    {
      "id": 456,
      "inner_id": "152471636",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "152471637",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 4800 }
    },
    {
      "id": 458,
      "inner_id": "152471638",
      "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/guazi/offer?api_key=YOUR_API_KEY&inner_id=152471636

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

Retención

Mínimo 3+ días

Disponibilidad

Archivos diarios

CSV

Separador pipe (|)

URL:

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

Parámetros:

  • access_name - access_name - ID
  • date - date - yyyy-mm-dd
  • file_name - file_name - archivo

Formatos:

  • 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

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

Wget

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

Guazi es una de las plataformas más grandes de China para comprar y vender autos usados. Conecta compradores con vendedores en todo el país, procesando miles de transacciones diarias.

La plataforma ofrece servicios de inspección, verificación de historial y garantías para dar confianza a los compradores. Guazi se ha convertido en líder del mercado chino de vehículos de segunda mano.

Con presencia en principales ciudades chinas, Guazi proporciona listados detallados, comparativas de precios y herramientas de búsqueda avanzada para facilitar la compra de autos usados.

Nuestra API entrega datos estructurados del mercado de Guazi a través de endpoints estables. Utilícela en sus aplicaciones para análisis de precios, seguimiento de inventario y análisis de mercado.

La API de Guazi proporciona acceso completo a listados de vehículos usados del mercado chino con llamadas API estructuradas.

Respuesta en 2 min