
Guazi APIScraper & Parser
Dostęp do certyfikowanych danych o używanych samochodach z największej chińskiej platformy przez API. Raporty 259-punktowej inspekcji, historia wypadków, stan magazynowy w czasie rzeczywistym bez scraperów.
API platformy używanych samochodów Guazi
Uzyskaj dostęp do wiodącego chińskiego rynku certyfikowanych używanych samochodów przez nasze API. Pobieraj czyste dane z Szanghaju, Pekinu i głównych chińskich miast do analizy rynku i zarządzania magazynem.
Otrzymuj natychmiastowe alerty o nowych ogłoszeniach certyfikowanych używanych samochodów.
Codzienny eksport wszystkich aktywnych certyfikowanych samochodów do śledzenia rynku.
Uzyskaj dostęp do kompleksowych danych o używanych samochodach: cena, specyfikacje, raporty inspekcji, status certyfikacji, historia wypadków, szczegóły gwarancji z każdego ogłoszenia.
Bazowy URL
https://{access_name}.auto-api.com/api/v2/guaziAutoryzacja: api_key parametr
Schemat integracji
/filterspobierz dostępne wartości filtrów/offerspobierz ogłoszenia (z filtrami lub bez) - użyj do początkowego ładowania danychDla aktualizacji (utrzymanie aktualności danych po początkowym ładowaniu):
/change_id?date=...pobierz początkowe ID dla strumienia zmian/changes?change_id=...pobierz wszystkie zmiany w bazie danych od podanego ID/offerpobierz szczegóły konkretnego ogłoszenia według inner_idJak skutecznie zintegrować:
1. Najpierw użyj /offers, aby pobrać cały zestaw danych (paginuj przez wszystkie wyniki)
2. Następnie okresowo odpytuj /changes, aby uzyskać wszystkie aktualizacje (nowe/zaktualizowane/usunięte rekordy) i synchronizuj lokalną bazę danych ze źródłem
3. Do integracji front-end użyj /offers z konkretnymi filtrami i paginacją (marka, model, przedział cenowy, rok itp.)
GET/filters
Zwraca wszystkie możliwe wartości do filtrowania
https://{access_name}.auto-api.com/api/v2/guazi/filters?api_key=YOUR_API_KEYOdpowiedź:
{
"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 ogłoszeń z paginacją i filtrami
Parametry:
page(wymagane) - numer stronymark, model, transmission_type, color, rudder, body_type, engine_type, drive_type- filtry (bez rozróżniania wielkości liter)year_from, year_to- filtr zakresu latkm_age_from, km_age_to- filtr zakresu przebieguprice_from, price_to- filtr zakresu cen (w 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=blackOdpowiedź:
{
"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 }
}Pola danych:
- id - wewnętrzne ID bazy danych
- inner_id - ID ogłoszenia na platformie
- url - link do ogłoszenia
- title - tytuł ogłoszenia
- mark - marka samochodu
- model - model samochodu
- full_model - pełna nazwa modelu
- transmission_type - typ skrzyni biegów (AT/MT)
- year - rok produkcji
- km_age - przebieg w km
- price - cena w CNY
- color - kolor
- displacement - pojemność silnika
- doors_count - liczba drzwi
- region - region
- city - miasto
- address - adres
- section - sekcja
- rudder - pozycja kierownicy (lewa/prawa)
- body_type - typ nadwozia
- engine_type - typ silnika
- equipment - lista wyposażenia
- images - tablica URL-i zdjęć
- drive_type - typ napędu (FWD/RWD/AWD)
- productionYearMonth - data produkcji (rok-miesiąc)
- licenseDate - data rejestracji
GET/change_id
Pobierz pierwsze ID zmiany według daty (do użycia w /changes)
Parametry:
date(wymagane) - data w formacie yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/guazi/change_id?api_key=YOUR_API_KEY&date=2025-01-15Odpowiedź:
{ "change_id": 6718293 }Użyj zwróconej wartości jako parametru change_id w /changes
GET/changes
Strumień zmian (dodano/zmieniono/usunięto)
Parametry:
change_id(wymagane) - od którego ID zmiany
https://{access_name}.auto-api.com/api/v2/guazi/changes?api_key=YOUR_API_KEY&change_id=1Odpowiedź:
{
"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
Pojedyncze ogłoszenie według inner_id
Parametry:
inner_id(wymagane)
https://{access_name}.auto-api.com/api/v2/guazi/offer?api_key=YOUR_API_KEY&inner_id=152471636Odpowiedź: obiekt data (taki sam jak w /offers, ale bez wrappera result)
Protokół przechowywania danych
Pliki są przechowywane przez 3+ dni.
Harmonogram dostarczania API
Codzienne pliki są gotowe do pobrania.
Konfiguracja pliku CSV
Pliki CSV używają kreski pionowej (|) jako separatora kolumn.
Struktura URL:
Parametry Żądania:
access_name- access_name - przypisany identyfikator subdomenydate- date - data docelowa w formacie RRRR-MM-DD (np. 2025-09-22)file_name- file_name - nazwa pliku eksportu z rozszerzeniem
Dostępne Formaty:
- 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
Przykład Żądania 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.csvPrzykład pobrania przez Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Guazi to największa chińska platforma certyfikowanych używanych samochodów. Założona w celu wprowadzenia przejrzystości na rynek używanych samochodów, łączy kupujących z wysokiej jakości pojazdami używanymi w głównych miastach. Każdy samochód przechodzi profesjonalną 259-punktową inspekcję przed wystawieniem.
Każde ogłoszenie zawiera szczegółowe raporty inspekcji, pełną historię wypadków, profesjonalną fotografię i przejrzyste ceny. Proces certyfikacji Guazi zapewnia kupującym dokładne informacje o pojeździe, w tym ukryte problemy i historię napraw.
Platforma oferuje opcje finansowania, rozszerzone gwarancje i wsparcie posprzedażowe. Zaawansowane filtry wyszukiwania pomagają kupującym znaleźć samochody według marki, modelu, roku, przedziału cenowego, przebiegu i poziomu certyfikacji. Aktualizacje magazynu w czasie rzeczywistym utrzymują ogłoszenia na bieżąco.
Nasze API dostarcza ustrukturyzowane dane z rynku Guazi przez stabilne endpointy. Zintegruj inwentarz certyfikowanych używanych samochodów ze swoimi aplikacjami do analizy cen, badań rynku i automatycznego zarządzania magazynem.
API czasu rzeczywistego działa 24/7, wykrywając nowe certyfikowane ogłoszenia w ciągu kilku minut i śledząc sprzedane pojazdy, aby ujawnić rzeczywiste ceny transakcyjne. Uzyskaj dostęp do pełnych danych inspekcji i certyfikacji bez tworzenia niestandardowych scraperów.
Rozszerz swój zasięg danych motoryzacyjnych na rynki globalne dzięki naszym wszechstronnym interfejsom API dla platform: