
Guazi APIScraper & Parser
Přístup k certifikovaným datům ojetých vozů z největší čínské platformy přes API. 259bodové inspekční zprávy, historie nehod, inventář v reálném čase bez scraperů.
API Platformy Ojetých Vozů Guazi
Získejte přístup k přednímu čínskému tržišti certifikovaných ojetých vozů přes naše API. Získávejte čistá data ze Šanghaje, Pekingu a velkých čínských měst pro analýzu trhu a správu inventáře.
Přijímejte okamžité upozornění na nové inzeráty certifikovaných ojetých vozů.
Denní export všech aktivních certifikovaných vozů pro sledování trhu.
Přístup ke komplexním datům ojetých vozů: cena, specifikace, inspekční zprávy, stav certifikace, historie nehod, detaily záruky z každého inzerátu.
Základní URL
https://{access_name}.auto-api.com/api/v2/guaziAutorizace: api_key parametr
Pracovní postup
/filterszískat dostupné hodnoty filtrů/offerszískat inzeráty (s filtry nebo bez nich) - použít pro počáteční načtení datPro aktualizace (udržování dat aktuálních po počátečním načtení):
/change_id?date=...získat počáteční ID pro stream změn/changes?change_id=...získat všechny změny v databázi od daného ID/offerzískat detaily konkrétního inzerátu podle inner_idJak efektivně integrovat:
1. Nejprve použijte /offers pro získání celé sady dat (projděte všechny výsledky)
2. Poté pravidelně dotazujte /changes pro získání všech aktualizací (nové/aktualizované/odstraněné záznamy) pro synchronizaci vaší lokální databáze se zdrojem
3. Pro front-end integraci použijte /offers s konkrétními filtry a stránkováním (značka, model, cenový rozsah, rok atd.)
GET/filters
Vrací všechny možné hodnoty pro filtrování
https://{access_name}.auto-api.com/api/v2/guazi/filters?api_key=YOUR_API_KEYOdpověď:
{
"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
Seznam inzerátů s stránkováním a filtry
Parametry:
page(povinné) - číslo stránkymark, model, transmission_type, color, rudder, body_type, engine_type, drive_type- filtry (bez rozlišení velkých/malých písmen)year_from, year_to- filtr rozsahu letkm_age_from, km_age_to- filtr rozsahu kilometrůprice_from, price_to- filtr rozsahu cen (v 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=blackOdpověď:
{
"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 }
}Datová pole:
- id - interní ID databáze
- inner_id - ID inzerátu na platformě
- url - odkaz na inzerát
- title - název inzerátu
- mark - značka auta
- model - model auta
- full_model - plný název modelu
- transmission_type - typ převodovky (AT/MT)
- year - rok výroby
- km_age - nájezd v km
- price - cena v CNY
- color - barva
- displacement - objem motoru
- doors_count - počet dveří
- region - region
- city - město
- address - adresa
- section - sekce
- rudder - pozice volantu (vlevo/vpravo)
- body_type - typ karoserie
- engine_type - typ motoru
- equipment - seznam výbavy
- images - pole URL obrázků
- drive_type - typ pohonu (FWD/RWD/AWD)
- productionYearMonth - datum výroby (rok-měsíc)
- licenseDate - datum registrace
GET/change_id
Získat první ID změny podle data (pro použití v /changes)
Parametry:
date(povinné) - datum ve formátu yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/guazi/change_id?api_key=YOUR_API_KEY&date=2025-01-15Odpověď:
{ "change_id": 6718293 }Použijte vrácenou hodnotu jako parametr change_id v /changes
GET/changes
Stream změn (přidáno/změněno/odstraněno)
Parametry:
change_id(povinné) - od kterého ID změny
https://{access_name}.auto-api.com/api/v2/guazi/changes?api_key=YOUR_API_KEY&change_id=1Odpověď:
{
"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
Jednotlivý inzerát podle inner_id
Parametry:
inner_id(povinné)
https://{access_name}.auto-api.com/api/v2/guazi/offer?api_key=YOUR_API_KEY&inner_id=152471636Odpověď: objekt data (stejný jako v /offers, ale bez wrapperu result)
Protokol Uchovávání Dat
Soubory jsou uchovávány po dobu 3+ dní.
Harmonogram Dodávání API
Denní soubory jsou připraveny ke stažení.
Konfigurace CSV Souboru
CSV soubory používají svislou čáru (|) jako oddělovač sloupců.
Struktura URL:
Parametry Požadavku:
access_name- access_name - váš přidělený identifikátor subdoménydate- date - cílové datum ve formátu rrrr-mm-dd (např. 2025-09-22)file_name- file_name - název exportního souboru s příponou
Dostupné Formáty:
- 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
Příklad API Požadavku 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.csvPříkaz Stažení Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Guazi je největší čínská platforma certifikovaných ojetých vozů. Byla založena s cílem vnést transparentnost do trhu s ojetými vozy a propojuje kupující s kvalitními vozidly ve velkých městech. Každé auto prochází důkladnou profesionální inspekcí o 259 bodech ještě před zveřejněním.
Každý inzerát přináší detailní inspekční zprávy, kompletní historii nehod, profesionální fotografie a transparentní ceny. Certifikační proces Guazi garantuje kupujícím přesné informace o vozidle - včetně případných skrytých problémů a kompletní historie oprav.
Platforma nabízí financování, prodloužené záruky a komplexní poprodejní podporu. Díky pokročilým vyhledávacím filtrům kupující snadno najdou ideální vůz podle značky, modelu, roku výroby, cenové kategorie, nájezdu kilometrů a úrovně certifikace. Inventář se aktualizuje v reálném čase, takže všechny inzeráty jsou vždy aktuální.
Naše API dodává strukturovaná data z tržiště Guazi prostřednictvím stabilních endpointů. Integrujte kompletní inventář certifikovaných ojetých vozů do svých aplikací pro cenové analýzy, průzkum trhu a automatizovanou správu zásob.
Naše API v reálném čase běží nepřetržitě 24/7, odhaluje nové certifikované inzeráty během několika minut a sleduje prodaná vozidla, aby odhalilo skutečné prodejní ceny. Získejte přístup ke kompletním datům o inspekcích a certifikacích bez nutnosti vytvářet vlastní scrapery.
Automobilová data z různých světových trhů s našimi platformovými API: