
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.
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.
Merrni njoftime të menjëhershme për shpalljet e reja të certifikuara.
Eksportim ditor i të gjitha makinave aktive të certifikuara, për ndjekjen e tregut.
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.
Shpallja vjen me çmimet sipas portit të ngarkimit, rezultatet e inspektimit të Guazi, specifikimet e versionit dhe pajisjet.
URL bazë
https://{access_name}.auto-api.com/api/v3/guaziAutorizimi: api_key parametër
Rrjedha e punës
/filtersmerrni vlerat e disponueshme të filtraveNgarkimi fillestar:
/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve/offersmerrni të gjitha shpalljet faqe pas faqeje/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_idSi të filloni:
1. Para ngarkimit të parë, merrni numrin nga /change_id për datën e sotme dhe ruajeni. Pastaj kaloni nëpër /offers faqe pas faqeje deri në fund: në faqen e fundit next_page është null.
2. Më pas thirrni rregullisht /changes duke filluar nga ky numër dhe dërgoni next_change_id nga çdo përgjigje. Kështu vijnë shpalljet e reja, çmimet e reja dhe heqjet nga shitja. Nëse next_change_id është null, ende nuk ka ngjarje: përsëritni të njëjtën kërkesë më vonë.
3. Për të kërkuar sipas kritereve tuaja, thirrni /offers me filtra.
Formati i të dhënave
- Llojet e të dhënave ruhen: një numër vjen si numër, një listë si varg, një vlerë që mungon si null.
- Vulat kohore janë në UTC, për shembull "2026-10-22T14:25:09Z". Datat jepen si "2024-07-15", muajt si "2024-06".
- Të gjitha shumat janë në USD.
- Çdo shpallje ka të njëjtët çelësa. Nëse një bllok si inspektimi i Guazi nuk ka të dhëna, blloku është null.
GET/filters
Kthen të gjitha vlerat e mundshme për filtrim
https://{access_name}.auto-api.com/api/v3/guazi/filters?api_key=YOUR_API_KEYPërgjigjja:
{
"mark": {
"Hima": { "model": ["AITO M5", "AITO M6", "AITO M7", "AITO M8", "AITO M9", ...] },
"Li Auto": { "model": ["i6", "i8", "L6", "L7", "L8", ...] },
"Zeekr": { "model": ["001", "001FR", "007", "007GT", "009", ...] },
...
},
"transmission_type": ["Automatic", "Manual"],
"color": ["Black", "Blue", "Brown", "Champagne", ...],
"body_type": ["Convertible", "Hatchback", "Minivan", "Pickup", ...],
"engine_type": [..., "Hybrid", "Plug-in hybrid (PHEV)", "Range extender (EREV)"],
"drive_type": ["2WD", "4WD", "AWD", ..., "FWD", ..., "RWD"]
}GET/offers
Shpalljet faqe pas faqeje. Filtrat i ngushtojnë rezultatet.
Parametrat:
page(i detyrueshëm) - numri i faqesmark, model- marka dhe modeli, saktësisht siç shkruhen në /filterstransmission_type, color, body_type, engine_type, drive_type- transmisioni, ngjyra, karroceria, karburanti dhe tërheqja, me vlerat nga /filters, pa dallim midis shkronjave të mëdha dhe të voglayear_from, year_to- viti i prodhimit, nga dhe derikm_age_from, km_age_to- kilometrazhi në km, nga dhe deriprice_from, price_to- çmimi në dollarë amerikanë, nga dhe deri
Për të dërguar disa vlera në një filtër, përsëritni parametrin me kllapa katrore: mark[]=Li Auto&mark[]=Hima
https://{access_name}.auto-api.com/api/v3/guazi/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/guazi/offers?api_key=YOUR_API_KEY&page=1&mark=Hima&model=AITO M9&year_from=2024https://{access_name}.auto-api.com/api/v3/guazi/offers?api_key=YOUR_API_KEY&page=1&mark[]=Li Auto&mark[]=Hima&engine_type=Range extender (EREV)&price_to=45000Përgjigjja:
{
"result": [
{
"id": 274913,
"inner_id": "aq3kg9gkg8",
"change_type": "added",
"created_at": "2026-10-22T14:25:09Z",
"data": {
"id": 274913,
"inner_id": "aq3kg9gkg8",
"url": "https://en.guazi.com/products/hima-aito-m9-2024-15l-black-52300km-at-4wd-6-seats-aq3kg9gkg8.html",
"mark": "Hima",
"model": "AITO M9",
"complectation": "Hima AITO M9 2024 Range-Extended Max Edition 42 kWh 6-Seater Version",
"configuration": "Range-Extended Max Edition 42 kWh 6-Seater Version",
"year": 2024,
"model_year": 2024,
"year_month": "2024-06",
"first_registration": "2024-07",
"first_registration_date": "2024-07-15",
"km_age": 52300,
"owners_count": null,
"price": 42313,
"currency": "USD",
"port_prices": {
"Shanghai": 42313,
"Ningbo": 42328,
"Guangzhou": 42276,
"Shenzhen": 42306,
"Horgos": 42178,
"Suifenhe": 41848
},
"engine_type": "Range extender (EREV)",
"transmission_type": "Automatic",
"body_type": "SUV",
"drive_type": "AWD",
"color": "Black",
"doors_count": 5,
"displacement": 1.5,
"displacement_cc": null,
"engine_model": "H15RT",
"power": 496,
"power_ice_hp": 152,
"power_ice_kw": 112,
"power_electro_kw": 365,
"power_electro_rear_kw": 200,
"battery_capacity_kwh": 42,
"battery_type": "Nickel cobalt manganese (NCM)",
"battery_soh_percent": null,
"electric_range_km": 225,
"seat_count": 6,
"section": "Used",
"seller_type": "Private seller",
"is_dealer": false,
"salon_id": null,
"city": "Quanzhou",
"region": "Fujian",
"address": "Quanzhou,China",
"description": null,
"created_at": "2026-10-22T14:25:09Z",
"photos": [
"https://global-image-pub.guazistatic-global.com/qnbdp7206xeeda47ed7325479e90a82d3248206dce1783849682.jpg",
"https://global-image-pub.guazistatic-global.com/qnbdp7206x485fb37f388f4c4184630c17600dcbf31783849695.jpg",
"https://global-image-pub.guazistatic-global.com/qnbdp7206xee9b0a79ac6f422b97f4ba9cec0968941783849708.jpg",
"https://global-image-pub.guazistatic-global.com/qnbdp7206xc60477222d5d44b8a2c4d30793825f351783849724.jpg",
...
],
"photo_details": [
...
{
"type": "Details",
"view": "Engine bay",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7206xe821e4c6eeca4f62b3f868f0ec0dc3d31783849220.jpg"
},
{
"type": "Details",
"view": "Engine bay, left",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x75b5adbe179a4f6d87d9a126bf89578c1783846837.jpg"
},
{
"type": "Details",
"view": "Engine bay, right",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x424e29bdeb3b4ea6bb648211910074931783846835.jpg"
},
{
"type": "Details",
"view": "Underbody, front",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964xaab7b843de664b1fb7a1afaa27bfca2a1783846744.jpg"
},
...
],
"highlights": [..., "Tire pressure monitoring", "Heated mirrors", "Hill start assist", "Rear parking sensors", "Anti-pinch windows"],
"inspection": {
"grade": "A",
"accident_damage": false,
"water_damage": false,
"fire_damage": false,
"checks": {
"Exterior": { "normal": 97, "issues": 15 },
"Interior": { "normal": 43, "issues": 0 },
"Equipment": { "normal": 53, "issues": 0 },
"Structural parts": { "normal": 30, "issues": 0 },
"Reinforcement parts": { "normal": 15, "issues": 0 },
"Cockpit": { "normal": 18, "issues": 0 },
"Electric system": { "normal": 10, "issues": 1 }
},
"condition_videos": [
{
"type": "Engine start",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x806ac68bf22044a18492e05c07b242431783849034.mp4"
},
{
"type": "Engine bay",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x2769a6d3cb6441b0a098f402bc1df6bb1783849052.mp4"
},
{
"type": "Exhaust",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x6591a557d2354588b921940385f204df1783849072.mp4"
}
],
"part_videos": []
},
"original": { // vlerat origjinale nga guazi.com
"mark": "Hima",
"model": "AITO M9",
"complectation": "Hima AITO M9 2024 Range-Extended Max Edition 42 kWh 6-Seater Version",
"engine_type": "REEV",
"transmission_type": "AT",
"body_type": "SUV",
"drive_type": "Dual Motor AWD",
"color": "Black",
"city": "Quanzhou"
},
"catalog_ids": {
"mark": "103950",
"model": "163411",
"complectation": "229576"
},
"options": {
"Safety": [..., "Brake force distribution (EBD/CBC)", "Brake assist (EBA/BAS/BA)", "Traction control (ASR/TCS/TRC)", "Stability control (ESC/ESP/DSC)"],
"Driver assistance": [..., "Air suspension", "Auto hold", "Hill start assist", "Traffic sign recognition"],
"Exterior and access": [..., "Central locking", "Remote key", "Keyless start", "Keyless entry"],
"Interior": [..., "Steering wheel memory", "Trip computer display", "Digital instrument cluster", "Over-the-air updates"],
"Seats": [..., "Second row seat sliding", "Seat memory", "Passenger seat adjustment from rear", "Rear cup holders"],
"Multimedia": ["Center console color display", "Smartphone integration", "Connected car services"],
"Lighting": [..., "Automatic high beam", "Automatic headlights", "Cornering lights", "Headlight leveling"],
"Windows and mirrors": [..., "Mirror memory", "Vanity mirror", "Rear wiper", "Rain-sensing wipers"]
},
"specs": {
"Engine": {
...
"Maximum power (hp)": "152.32",
"Maximum power (kW)": "112",
"Maximum torque (N·m)": "205"
},
"Electric motor": {
...
"Battery capacity (kWh)": "42",
"Battery type": "Nickel cobalt manganese (NCM)",
"Slow charging time (h)": "5",
"WLTC combined range (km)": "1210",
"CLTC electric range (km)": "225",
...
},
...
"Multimedia": {
"Center console color display": "Yes",
"Smartphone integration": "Yes",
"Connected car services": "Yes",
"Media ports": "USB+SD+Type-C"
},
...
}
}
}
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Fushat e të dhënave:
Shpallja
id - ID-ja e brendshme në bazën e të dhënave
inner_id - ID-ja e shpalljes në platformë
url - lidhja e shpalljes
price, currency - Çmimi në dollarë amerikanë, currency është gjithmonë USD.
port_prices - Çmimet në dollarë amerikanë sipas portit të ngarkimit: Shangai, Ningbo, Guangzhou, Shenzhen, Horgos, Suifenhe. Çmimi në Shangai është i njëjtë me fushën price. Nëse nuk ka çmime sipas porteve, port_prices është null.
section - "Used" ose "New".
description - Përshkrimi i shkruar nga shitësi. Guazi nuk e publikon, prandaj është gjithmonë null.
created_at - Koha kur shpallja hyri në bazën tonë të të dhënave.
Makina
mark, model - Marka dhe modeli.
complectation - Emri i plotë i versionit, siç shkruhet në shpallje.
configuration - Versioni (marka, modeli dhe viti nuk përfshihen).
year - Viti i prodhimit.
model_year - Viti i modelit.
year_month - Muaji i prodhimit.
first_registration, first_registration_date - Regjistrimi i parë: muaji dhe data e saktë.
km_age - kilometrazhi në km
owners_count - Numri i pronarëve. Guazi nuk e publikon, prandaj është gjithmonë null.
Specifikimet
engine_type - Lloji i motorit.
transmission_type - "Automatic" ose "Manual".
body_type - Lloji i karrocerisë, për shembull "SUV" ose "Minivan".
drive_type - Lloji i tërheqjes. Më së shpeshti "FWD", "RWD" ose "AWD".
color - Ngjyra e karrocerisë.
doors_count - Numri i dyerve.
displacement, displacement_cc - Vëllimi i motorit në litra. Guazi nuk e publikon në centimetra kub, prandaj displacement_cc është gjithmonë null.
engine_model - Kodi i motorit.
power - Fuqia totale, hp.
power_ice_hp, power_ice_kw - Motori me djegie të brendshme: hp dhe kW.
power_electro_kw - Të gjithë motorët elektrikë së bashku, kW.
power_electro_rear_kw - Motori elektrik i pasmë, kW.
battery_capacity_kwh, battery_type - Kapaciteti i baterisë në kWh dhe kimia e saj, për shembull "Lithium iron phosphate (LFP)".
battery_soh_percent - Sa përqind të kapacitetit fillestar ka ruajtur bateria. Nuk jepet për çdo makinë elektrike ose hibride.
electric_range_km - Autonomia me energji elektrike sipas ciklit CLTC, km.
seat_count - Numri i vendeve.
Shitësi
seller_type, is_dealer - "Dealer", "Private seller" ose "Guazi". "Guazi" shënon makinat që Guazi i shet në emër të vet. is_dealer është true për tregtarët dhe për Guazi.
salon_id - ID-ja e tregtarit. Guazi nuk e publikon, prandaj është gjithmonë null.
city, region - Qyteti dhe provinca e shitësit.
address - Qyteti dhe shteti, për shembull "Quanzhou,China".
Fotot, pajisjet dhe të dhënat referuese
photos - varg me URL imazhesh
photo_details - Të njëjtat foto me etiketa: kategoria e galerisë "Exterior", "Interior" ose "Details" (type) dhe këndi i fotografimit, për shembull "Front left 45°" (view). Nëse këndi nuk është shënuar, view është null.
highlights - Pajisjet kryesore të theksuara në shpallje, për shembull "Surround view cameras".
options - Pajisjet sipas grupeve: "Safety", "Driver assistance", "Exterior and access", "Interior", "Seats", "Multimedia", "Lighting", "Windows and mirrors". Shënimi "(optional)" do të thotë që ky element nuk bën pjesë në pajisjet standarde të këtij versioni.
specs - Specifikimet e versionit sipas seksioneve: "Engine", "Electric motor", "Body" dhe të njëjtat grupe pajisjesh si në fushën options. Vlerat jepen si string. Në grupet e pajisjeve ato janë më së shpeshti "Yes", "No" ose "Optional".
original - Emrat dhe vlerat origjinale nga guazi.com.
catalog_ids - Kodet e markës, modelit dhe versionit në katalogun e guazi.com.
Inspektimi i Guazi (inspection)
Rezultatet e inspektimit që e kryen Guazi. Nëse makina nuk është inspektuar, blloku inspection është null.
grade - Nota e inspektimit, nga S (më e mira) deri në D.
accident_damage, water_damage, fire_damage - Nëse janë gjetur dëmtime nga aksidenti, përmbytja ose zjarri (true/false).
checks - Për çdo kategori, sa pika të kontrolluara janë në rregull (normal) dhe sa kanë vërejtje (issues).
condition_videos - Videot e gjendjes së makinës: çfarë është xhiruar (type), për shembull "Engine start" ose "Exhaust", dhe lidhja e videos (url).
part_videos - Videot e inspektimit për zona të caktuara të karrocerisë dhe të brendësisë: zona (part), rezultati (result), për shembull "Normal" ose "Minor scratches", komenti i inspektorit (note) dhe lidhja e videos (url).
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/v3/guazi/change_id?api_key=YOUR_API_KEY&date=2026-10-22Përgjigjja:
{
"change_id": 517630
}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/v3/guazi/changes?api_key=YOUR_API_KEY&change_id=517640Përgjigjja:
{
"result": [
{
"id": 517640,
"inner_id": "xw3guery8m",
"change_type": "changed",
"created_at": "2026-10-22T10:07:21Z",
"data": { // çmimi ndryshoi, çmimi i ri në USD
"new_price": 9808
}
},
{
"id": 517647,
"inner_id": "magfq94j7n",
"change_type": "added",
"created_at": "2026-10-22T10:26:48Z",
"data": { ... } // trupi i plotë i shpalljes
},
{
"id": 517653,
"inner_id": "cdk64uu5z7",
"change_type": "removed",
"created_at": "2026-10-22T10:41:13Z",
"data": {} // u hoq nga shitja
}
// ... pastaj ngjarjet e tjera, deri në 20 për faqe
],
"meta": {
"cur_change_id": 517640,
"next_change_id": 517660,
"limit": 20
}
}GET/offer
Një shpallje e vetme sipas inner_id
Parametrat:
inner_id(i detyrueshëm)
https://{access_name}.auto-api.com/api/v3/guazi/offer?api_key=YOUR_API_KEY&inner_id=aq3kg9gkg8Përgjigjja përmban vetëm objektin data, pa mbështjellësin result.
Gabimet
Në rast gabimi, përgjigjja ka fushën error me një përshkrim: { "error": "parameter page is required" }
401- api_key nuk u pranua400- mungon një parametër i detyrueshëm ose një vlerë ka format të gabuar404- nuk ka shpallje me këtë inner_id (/offer)429- limiti i kërkesave është shteruar
Sipas lidhjes së një shpalljeje në guazi.com, API-ja kthen të dhënat e saj: fushat si në /offer dhe një bllok meta me limitin e mbetur.
URL bazë
https://{access_name}.auto-api.com/api/v2/offer/infoAutorizimi: header x-api-key
POST/api/v2/offer/info
Një shpallje sipas lidhjes së saj
Parametrat:
url(i detyrueshëm) - adresa e faqes së shpalljes në guazi.com
Shembull kërkese:
curl -L 'https://{access_name}.auto-api.com/api/v2/offer/info' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "url": "https://en.guazi.com/products/hima-aito-m9-2024-15l-black-52300km-at-4wd-6-seats-aq3kg9gkg8.html" }'Përgjigjja:
{
"id": 274913,
"inner_id": "aq3kg9gkg8",
"url": "https://en.guazi.com/products/hima-aito-m9-2024-15l-black-52300km-at-4wd-6-seats-aq3kg9gkg8.html",
"mark": "Hima",
"model": "AITO M9",
"complectation": "Hima AITO M9 2024 Range-Extended Max Edition 42 kWh 6-Seater Version",
"configuration": "Range-Extended Max Edition 42 kWh 6-Seater Version",
"year": 2024,
"model_year": 2024,
"year_month": "2024-06",
// ... fushat e tjera të shpalljes, si në /offer në API v3
"meta": {
"requests_made": 48,
"requests_left": 1952,
"requests_limit": 2000,
"period_start": "2026-11",
"platform": "guazi"
}
}Fushat e shpalljes janë të njëjta me ato që kthen /offer në API v3. Blloku meta vjen i fundit.
Çfarë ka në meta:
requests_made- sa kërkesa të suksesshme janë bërë këtë muajrequests_left- sa kërkesa mund të bëni enderequests_limit- limiti mujorperiod_start- muaji i numëruesitplatform- nga cila platformë është shpallja: encar, che168, dongchedi, guazi ose mobilede
Në limitin mujor llogariten vetëm përgjigjet me shpallje; gabimet nuk e harxhojnë.
Gabimet
Në rast gabimi, përgjigjja ka fushën error me një përshkrim: { "error": "Failed to get info" }
401- x-api-key nuk u pranua400- lidhja mungon ose nuk u lexua dot, ose platforma nuk është aktivizuar për çelësin422- të dhënat e shpalljes nuk u morën dot429- limiti i kërkesave është shteruar
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ë:
Parametrat e kërkesës:
access_name- identifikuesi i nëndomenit që ju është caktuardate- 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.csvKomanda e shkarkimit me Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'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ë.
Zgjeroni mbulimin e të dhënave tuaja automobilistike në tregjet botërore me API-të tona të platformave: