
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.
Listados de usados al momento.
Listados actuales.
Precio, Kilometraje, Estado, Historial, Especificaciones del vehículo usado.
URL base
https://{access_name}.auto-api.com/api/v2/guaziAutorización: api_key parámetro
Flujo de trabajo
/filtersobtener valores de filtro disponibles/offersobtener listados (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 listado específico por inner_idCó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_KEYRespuesta:
{
"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áginamark, 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ñoskm_age_from, km_age_to- filtro de rango de kilometrajeprice_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=blackRespuesta:
{
"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-15Respuesta:
{ "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=1Respuesta:
{
"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=152471636Respuesta: objeto data (igual que en /offers, pero sin envoltorio result)
Retención
Mínimo 3+ días
Disponibilidad
Archivos diarios
CSV
Separador pipe (|)
URL:
Parámetros:
access_name- access_name - IDdate- date - yyyy-mm-ddfile_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.csvWget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'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.
Expanda su cobertura de datos automotrices en mercados globales con nuestras APIs de plataforma: