Çfarë është Guazi API dhe si funksionon?

Lidhuni me platformën më të madhe të makinave të përdorura në Kinë përmes API-së sonë. Merrni të dhëna të organizuara makinash përmes endpoint-eve REST. Ndiqni në kohë reale makinat e përdorura të certifikuara, ndryshimet e çmimeve dhe automjetet e shitura.

Çfarë të dhënash nga Guazi jep API-ja?

Të dhënat e plota të automjetit: marka, modeli, çmimi, kilometrazhi, statusi i certifikimit, raportet e inspektimit, historiku i aksidenteve dhe fotot profesionale nga të gjitha shpalljet në Guazi.

Sa shpesh përditësohen të dhënat e Guazi?

Fluks i vazhdueshëm të dhënash. Shpalljet e reja të makinave të përdorura zbulohen brenda pak minutash. Skedarët ditorë përfshijnë të gjitha automjetet aktive të certifikuara dhe makinat e shitura së fundmi.

Çfarë formatesh mbështet Guazi API?

Disa formate: REST API për përditësime në kohë reale, JSON për të dhëna të strukturuara, CSV për analizë dhe Excel për raporte biznesi. Të gjitha formatet përfshijnë të dhënat e plota të inspektimit dhe të certifikimit.

Çfarë është inspektimi në 259 pika që përfshihet në të dhëna?

Çdo shpallje në Guazi përfshin rezultatet e inspektimit profesional gjithëpërfshirës në 259 pika që bën platforma. API-ja jep statusin e inspektimit, raporte të hollësishme dhe nivelet e certifikimit për çdo automjet.

Sa shpesh përditësohen eksportimet ditore?

Skedarët e rinj krijohen çdo mëngjes. Përmbajnë një pamje të plotë të shpalljeve aktive dhe një listë të automjeteve të hequra nga shitja ditën e mëparshme.

A mund të kem qasje në historikun e plotë të aksidenteve përmes API-së?

Po, të gjitha shpalljet përfshijnë raporte të plota të historikut të aksidenteve. Të dhënat tregojnë dëmtimet e mëparshme, evidencën e riparimeve dhe statusin e certifikimit sipas procesit të verifikimit në Guazi.

Guazi APIScraper & Parser

API me të dhëna nga platforma më e madhe në Kinë për makina të përdorura të certifikuara: inspektim në 259 pika, historik aksidentesh, stok në kohë reale. Pa scraper.

Biblioteka zyrtare SDK

Me kod të hapur, me përgjigje të tipizuara dhe pa asnjë konfigurim përveç çelësit tuaj API. Zgjidhni një gjuhë dhe filloni të tërhiqni shpallje nga Guazi.

PHP Node.js Python Go C#Java Ruby Rust

Guazi API

Merrni qasje në platformën kryesuese të makinave të përdorura të certifikuara në Kinë përmes API-së sonë. Tërhiqni të dhëna të pastra nga Shangai, Pekini dhe qytete të mëdha kineze për analizë tregu dhe menaxhim stoku.

API

Merrni njoftime të menjëhershme për shpalljet e reja të certifikuara.

Eksportime ditore

Eksportim ditor i të gjitha makinave aktive të certifikuara, për ndjekjen e tregut.

Të dhëna të plota

Merrni qasje në të dhëna gjithëpërfshirëse makinash të përdorura: çmimi, specifikimet, raportet e inspektimit, statusi i certifikimit, historiku i aksidenteve, të dhënat e garancisë nga çdo shpallje.

Merrni qasje në APIQasja jepet brenda 2 minutash

API

URL bazë

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

Autorizimi: api_key parametër

Rrjedha e punës

/filtersmerrni vlerat e disponueshme të filtrave

/offersmerrni shpallje (me ose pa filtra) - përdoreni për ngarkimin fillestar të të dhënave

Për përditësime (që t'i mbani të dhënat të përditësuara pas ngarkimit fillestar):

/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve

/changes?change_id=...merrni të gjitha ndryshimet në bazën e të dhënave duke filluar nga ID-ja

/offermerrni të dhënat e një shpalljeje të caktuar sipas inner_id

Si ta bëni integrimin në mënyrë efektive:

1. Së pari përdorni /offers për të tërhequr të gjithë setin e të dhënave (kaloni faqe pas faqeje nëpër të gjitha rezultatet)

2. Më pas bëni periodikisht kërkesë te /changes për të marrë të gjitha përditësimet (rekorde të reja/të përditësuara/të hequra), që të sinkronizoni bazën tuaj lokale të të dhënave me burimin

3. Për integrimin në frontend përdorni /offers me filtra të caktuar dhe faqosje (marka, modeli, intervali i çmimit, viti etj.)

GET/filters

Kthen të gjitha vlerat e mundshme për filtrim

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

Përgjigjja:

{
  "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 e shpalljeve me faqosje dhe filtra

Parametrat:

page (i detyrueshëm) - numri i faqes
mark, model, transmission_type, color, rudder, body_type, engine_type, drive_type - filtra (pa dallim midis shkronjave të mëdha dhe të vogla)
year_from, year_to - filtër sipas intervalit të viteve
km_age_from, km_age_to - filtër sipas intervalit të kilometrazhit
price_from, price_to - filtër sipas intervalit të çmimit (në 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

Përgjigjja:

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

Fushat e të dhënave:

id - ID-ja e brendshme në bazën e të dhënave
inner_id - ID-ja e shpalljes në platformë
url - lidhja e shpalljes
title - titulli i shpalljes
mark - marka e makinës
model - modeli i makinës
full_model - emri i plotë i modelit
transmission_type - lloji i transmisionit (AT/MT)
year - viti i prodhimit
km_age - kilometrazhi në km
price - çmimi në CNY
color - ngjyra
displacement - vëllimi i motorit

doors_count - numri i dyerve
region - rajoni
city - qyteti
address - adresa
section - seksioni
rudder - pozicioni i timonit (majtas/djathtas)
body_type - lloji i karrocerisë
engine_type - lloji i motorit
equipment - lista e pajisjeve
images - varg me URL imazhesh
drive_type - lloji i tërheqjes (FWD/RWD/AWD)
productionYearMonth - data e prodhimit (vit-muaj)
licenseDate - data e regjistrimit

GET/change_id

Merrni ID-në e parë të ndryshimit sipas datës (për përdorim në /changes)

Parametrat:

date (i detyrueshëm) - data në formatin yyyy-mm-dd

https://{access_name}.auto-api.com/api/v2/guazi/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Përgjigjja:

{ "change_id": 6718293 }

Përdorni vlerën e kthyer si parametrin change_id në /changes

GET/changes

Fluksi i ndryshimeve (të shtuara/të ndryshuara/të hequra)

Parametrat:

change_id (i detyrueshëm) - nga cila ID ndryshimi të fillohet

https://{access_name}.auto-api.com/api/v2/guazi/changes?api_key=YOUR_API_KEY&change_id=1

Përgjigjja:

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

Një shpallje e vetme sipas inner_id

Parametrat:

inner_id (i detyrueshëm)

https://{access_name}.auto-api.com/api/v2/guazi/offer?api_key=YOUR_API_KEY&inner_id=152471636

Përgjigjja: objekti data (i njëjtë si në /offers, por pa mbështjellësin result)

Eksportime ditore

Protokolli i ruajtjes së të dhënave

Skedarët ruhen për 3+ ditë.

Orari i dërgimit përmes API-së

Skedarët ditorë janë gati për shkarkim.

Konfigurimi i skedarit CSV

Skedarët CSV përdorin vijën vertikale (|) si ndarës kolonash.

Struktura e URL-së:

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

Parametrat e kërkesës:

access_name - identifikuesi i nëndomenit që ju është caktuar
date - data e dëshiruar në formatin yyyy-mm-dd (p.sh. 2025-09-22)
file_name - emri i skedarit të eksportimit me prapashtesë

Formatet e disponueshme:

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

Shembull kërkese API me 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

Komanda e shkarkimit me Wget

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

Guazi.com

Guazi është platforma më e madhe e makinave të përdorura të certifikuara në Kinë. U themelua për të sjellë transparencë në tregun e makinave të përdorura dhe i lidh blerësit me automjete të përdorura cilësore nëpër qytetet e mëdha. Çdo makinë kalon një inspektim profesional në 259 pika para se të dalë në shitje.

Çdo shpallje përmban raporte të hollësishme inspektimi, historik të plotë aksidentesh, foto profesionale dhe çmime transparente. Procesi i certifikimit në Guazi u siguron blerësve të dhëna të sakta për automjetin, përfshirë problemet e fshehura dhe historikun e riparimeve.

Platforma ofron mundësi financimi, garanci të zgjatura dhe mbështetje pas shitjes. Filtrat e avancuar të kërkimit i ndihmojnë blerësit të gjejnë makina sipas markës, modelit, vitit, intervalit të çmimit, kilometrazhit dhe nivelit të certifikimit. Përditësimet e stokut në kohë reale bëjnë që shpalljet të mbeten aktuale.

API-ja jonë jep të dhëna të strukturuara nga platforma Guazi përmes endpoint-eve të qëndrueshme. Integroni në aplikacionet tuaja stokun e makinave të përdorura të certifikuara, për analizë çmimesh, studim tregu dhe menaxhim të automatizuar të stokut.

API-ja në kohë reale punon 24/7. Zbulon shpalljet e reja brenda pak minutash dhe ndjek automjetet e shitura, për të treguar çmimet reale të transaksioneve. Merrni qasje në të dhënat e plota të inspektimit dhe të certifikimit pa ndërtuar scraper vetë.

Të dhëna të tjera automobilistike

Zgjeroni mbulimin e të dhënave tuaja automobilistike në tregjet botërore me API-të tona të platformave:

🇰🇷

Encar API

API për makina në Kore

🇰🇷

KB Chachacha API

API për makina në Kore

🇰🇷

K Car API

API për makina në Kore

🇨🇳