AUTO-API.COM
Logo Guazi.com

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.

API na żywo

Otrzymuj natychmiastowe alerty o nowych ogłoszeniach certyfikowanych używanych samochodów.

Codzienne Eksporty

Codzienny eksport wszystkich aktywnych certyfikowanych samochodów do śledzenia rynku.

Parser danych

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.

Uzyskaj Dostęp do APIDostęp przyznany w ciągu 2 minut

Bazowy URL

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

Autoryzacja: api_key parametr

Schemat integracji

1
/filterspobierz dostępne wartości filtrów
2
/offerspobierz ogłoszenia (z filtrami lub bez) - użyj do początkowego ładowania danych
3

Dla 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
4
/offerpobierz szczegóły konkretnego ogłoszenia według inner_id

Jak 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_KEY

Odpowiedź:

{
  "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 strony
  • mark, model, transmission_type, color, rudder, body_type, engine_type, drive_type - filtry (bez rozróżniania wielkości liter)
  • year_from, year_to - filtr zakresu lat
  • km_age_from, km_age_to - filtr zakresu przebiegu
  • price_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=black

Odpowiedź:

{
  "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-15

Odpowiedź:

{ "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=1

Odpowiedź:

{
  "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=152471636

Odpowiedź: 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:

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

Parametry Żądania:

  • access_name - access_name - przypisany identyfikator subdomeny
  • date - 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.csv

Przykład pobrania przez Wget

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

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.

Odpowiedź w 2 min