
Guazi APIScraper & Parser
API за сертифицирани употребявани автомобили от най-голямата платформа в Китай: 259-точкова проверка, история на произшествията, наличности в реално време, без скрейпъри.
Guazi API
Получете достъп до водещия онлайн пазар за сертифицирани употребявани автомобили в Китай чрез нашето API. Извличайте изчистени данни от Шанхай, Пекин и големите китайски градове за анализ на пазара и управление на наличностите.
Получавайте незабавни известия за нови обяви за сертифицирани автомобили.
Ежедневен експорт с всички налични сертифицирани автомобили за проследяване на пазара.
Получете достъп до изчерпателни данни за употребявани автомобили: цена, характеристики, доклади от проверката, статус на сертификацията, история на произшествията, данни за гаранцията от всяка обява.
Обявата идва с цени по пунктове на изпращане, резултатите от проверката от Guazi, характеристиките на версията и оборудването.
Базов URL
https://{access_name}.auto-api.com/api/v3/guaziОторизация: api_key параметър
Ред на работа
/filtersполучаване на наличните стойности на филтритеПървоначално зареждане:
/change_id?date=...получаване на началното ID за потока от промени/offersполучаване на всички обяви страница по страница/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID/offerполучаване на данни за конкретна обява по inner_idОткъде да започнете:
1. Преди първото зареждане вземете номера от /change_id за днешната дата и го запазете. След това преминете през /offers страница по страница до края: на последната страница next_page е null.
2. После извиквайте /changes, като започнете от този номер, и подавайте next_change_id от всеки отговор. Така пристигат новите обяви, новите цени и свалените от продажба автомобили. Ако next_change_id е null, все още няма събития: повторете същата заявка по-късно.
3. За да търсите по собствени критерии, извиквайте /offers с филтри.
Формат на данните
- Типовете се запазват: числото идва като число, списъкът като масив, а липсващата стойност като null.
- Датата и часът се дават в UTC, например "2026-10-22T14:25:09Z". Датите имат вида "2024-07-15", а месеците вида "2024-06".
- Всички суми са в USD.
- Всички обяви имат едни и същи ключове. Ако за даден блок, например проверката от Guazi, няма данни, блокът е null.
GET/filters
Връща всички възможни стойности за филтриране
https://{access_name}.auto-api.com/api/v3/guazi/filters?api_key=YOUR_API_KEYОтговор:
{
"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
Обяви страница по страница. Филтрите стесняват резултатите.
Параметри:
page(задължително) - номер на страницатаmark, model- марка и модел, изписани точно както във /filterstransmission_type, color, body_type, engine_type, drive_type- скоростна кутия, цвят, каросерия, гориво и задвижване със стойностите от /filters, без разлика между главни и малки буквиyear_from, year_to- година на производство от и доkm_age_from, km_age_to- пробег в км от и доprice_from, price_to- цена в щатски долари от и до
За да подадете няколко стойности на един филтър, повторете параметъра със скоби: 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=45000Отговор:
{
"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": { // оригинални стойности от 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
}
}Полета с данни:
Обява
id - вътрешно ID в базата данни
inner_id - ID на обявата в платформата
url - връзка към обявата
price, currency - Цена в щатски долари, currency винаги е USD.
port_prices - Цени в щатски долари по пунктове на изпращане: Шанхай, Нинбо, Гуанджоу, Шънджън, Хоргос, Суйфънхъ. Цената за Шанхай съвпада с полето price. Ако няма цени по пунктове на изпращане, port_prices е null.
section - "Used" или "New".
description - Описание от продавача. Guazi не го публикува, затова винаги е null.
created_at - Дата и час, когато обявата е постъпила в нашата база данни.
Автомобил
mark, model - Марка и модел.
complectation - Пълно име на версията, както е посочено в обявата.
configuration - Версия (марката, моделът и годината не са включени).
year - Година на производство.
model_year - Моделна година.
year_month - Месец на производство.
first_registration, first_registration_date - Първа регистрация: месец и точна дата.
km_age - пробег в км
owners_count - Брой собственици. Guazi не го публикува, затова винаги е null.
Характеристики
engine_type - Тип двигател.
transmission_type - "Automatic" или "Manual".
body_type - Тип каросерия, например "SUV" или "Minivan".
drive_type - Тип задвижване. Най-често "FWD", "RWD" или "AWD".
color - Цвят на каросерията.
doors_count - Брой врати.
displacement, displacement_cc - Обем на двигателя в литри. Guazi не го публикува в кубически сантиметри, затова displacement_cc винаги е null.
engine_model - Код на двигателя.
power - Обща мощност, к.с.
power_ice_hp, power_ice_kw - Двигател с вътрешно горене: к.с. и kW.
power_electro_kw - Всички електромотори заедно, kW.
power_electro_rear_kw - Заден електромотор, kW.
battery_capacity_kwh, battery_type - Капацитет на батерията в kWh и химичният ѝ тип, например "Lithium iron phosphate (LFP)".
battery_soh_percent - Остатъчен капацитет на батерията в проценти от първоначалния. Не е посочен за всеки електромобил или хибрид.
electric_range_km - Пробег на електрическа тяга по цикъла CLTC, км.
seat_count - Брой места.
Продавач
seller_type, is_dealer - "Dealer", "Private seller" или "Guazi". Стойността "Guazi" се посочва при автомобилите, които Guazi продава от свое име. is_dealer е true при дилър и при Guazi.
salon_id - ID на дилъра. Guazi не го публикува, затова винаги е null.
city, region - Град и провинция на продавача.
address - Град и държава, например "Quanzhou,China".
Снимки, оборудване и справочни данни
photos - масив от URL адреси на изображения
photo_details - Същите снимки с надписи: категория в галерията "Exterior", "Interior" или "Details" (type) и ъгъл на снимане, например "Front left 45°" (view). Ако ъгълът не е посочен, view е null.
highlights - Най-важното оборудване, откроено в обявата, например "Surround view cameras".
options - Оборудване по групи: "Safety", "Driver assistance", "Exterior and access", "Interior", "Seats", "Multimedia", "Lighting", "Windows and mirrors". Означението "(optional)" показва, че позицията не е част от стандартното оборудване на тази версия.
specs - Характеристики на версията по раздели: "Engine", "Electric motor", "Body" и същите групи с оборудване като в полето options. Стойностите са низове. В групите с оборудване най-често са "Yes", "No" или "Optional".
original - Оригинални имена и стойности от guazi.com.
catalog_ids - Кодове на марката, модела и версията в каталога на guazi.com.
Проверка от Guazi (inspection)
Резултати от проверката, извършена от Guazi. Ако автомобилът не е проверяван, блокът inspection е null.
grade - Оценка от проверката, от S (най-добра) до D.
accident_damage, water_damage, fire_damage - Дали са открити щети от произшествие, наводнение или пожар (true/false).
checks - За всяка категория: колко от проверените контролни точки са в норма (normal) и колко имат забележки (issues).
condition_videos - Видеа за състоянието на автомобила: какво е заснето (type), например "Engine start" или "Exhaust", и връзка към видеото (url).
part_videos - Видеа от проверката на отделни участъци от каросерията и интериора: участъкът (part), резултатът (result), например "Normal" или "Minor scratches", коментарът на инспектора (note) и връзката към видеото (url).
GET/change_id
Получаване на първото ID на промяна по дата (за използване в /changes)
Параметри:
date(задължително) - дата във формат yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/guazi/change_id?api_key=YOUR_API_KEY&date=2026-10-22Отговор:
{
"change_id": 517630
}Използвайте върнатата стойност като параметър change_id в /changes
GET/changes
Поток от промени (добавени/променени/премахнати)
Параметри:
change_id(задължително) - от кое ID на промяна да се започне
https://{access_name}.auto-api.com/api/v3/guazi/changes?api_key=YOUR_API_KEY&change_id=517640Отговор:
{
"result": [
{
"id": 517640,
"inner_id": "xw3guery8m",
"change_type": "changed",
"created_at": "2026-10-22T10:07:21Z",
"data": { // цената е променена, новата е в USD
"new_price": 9808
}
},
{
"id": 517647,
"inner_id": "magfq94j7n",
"change_type": "added",
"created_at": "2026-10-22T10:26:48Z",
"data": { ... } // цялото тяло на обявата
},
{
"id": 517653,
"inner_id": "cdk64uu5z7",
"change_type": "removed",
"created_at": "2026-10-22T10:41:13Z",
"data": {} // свален от продажба
}
// ... следват останалите събития, до 20 на страница
],
"meta": {
"cur_change_id": 517640,
"next_change_id": 517660,
"limit": 20
}
}GET/offer
Една обява по inner_id
Параметри:
inner_id(задължително)
https://{access_name}.auto-api.com/api/v3/guazi/offer?api_key=YOUR_API_KEY&inner_id=aq3kg9gkg8Отговорът съдържа само обекта data, без обвивката result.
Грешки
При грешка отговорът съдържа поле error с описание: { "error": "parameter page is required" }
401- ключът api_key не е приет400- липсва задължителен параметър или някоя стойност е в неправилен формат404- няма обява с такъв inner_id (/offer)429- лимитът на заявките е изчерпан
API-то връща данните на обява в guazi.com по връзка към нея: полетата както в /offer и блок meta с оставащия лимит.
Базов URL
https://{access_name}.auto-api.com/api/v2/offer/infoОторизация: хедър x-api-key
POST/api/v2/offer/info
Една обява по връзката към нея
Параметри:
url(задължително) - URL адрес на страницата на обявата в guazi.com
Примерна заявка:
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" }'Отговор:
{
"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",
// ... останалите полета на обявата, както в /offer на API v3
"meta": {
"requests_made": 48,
"requests_left": 1952,
"requests_limit": 2000,
"period_start": "2026-11",
"platform": "guazi"
}
}Полетата на обявата са същите, които връща /offer в API v3. Блокът meta идва последен.
Какво има в meta:
requests_made- колко успешни заявки са направени през текущия месецrequests_left- колко още заявки можете да направитеrequests_limit- месечният лимитperiod_start- месецът на броячаplatform- от коя платформа е обявата: encar, che168, dongchedi, guazi или mobilede
Към месечния лимит се отчитат само отговорите с обява, а грешките не го изразходват.
Грешки
При грешка отговорът съдържа поле error с описание: { "error": "Failed to get info" }
401- ключът x-api-key не е приет400- липсва връзка или тя не е разпозната, или платформата не е включена за ключа422- данните от обявата не могат да бъдат получени429- лимитът на заявките е изчерпан
Правила за съхранение на данните
Файловете се съхраняват поне 3 дни.
График на доставка чрез API
Ежедневните файлове са готови за изтегляне.
Настройки на CSV файла
CSV файловете използват вертикална черта (|) като разделител на колоните.
Структура на URL адреса:
Параметри на заявката:
access_name- предоставеният ви идентификатор на поддомейнаdate- желаната дата във формат yyyy-mm-dd (напр. 2025-09-22)file_name- име на експортния файл с разширението
Налични формати:
- 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
Примерна 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Команда за изтегляне с Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Guazi е най-голямата платформа за сертифицирани употребявани автомобили в Китай. Създадена, за да внесе прозрачност на пазара на употребявани автомобили, тя свързва купувачите с качествени употребявани автомобили в големите градове. Всеки автомобил преминава професионална 259-точкова проверка, преди да бъде обявен за продажба.
Всяка обява съдържа подробни доклади от проверката, пълна история на произшествията, професионални снимки и прозрачни цени. Процесът на сертификация на Guazi осигурява на купувачите точна информация за автомобила, включително скрити проблеми и история на ремонтите.
Платформата предлага възможности за финансиране, удължени гаранции и следпродажбено обслужване. Разширените филтри за търсене помагат на купувачите да намират автомобили по марка, модел, година, диапазон на цената, пробег и ниво на сертификация. Обновяванията на наличностите в реално време поддържат обявите актуални.
Нашето API доставя структурирани данни от платформата Guazi чрез стабилни крайни точки. Интегрирайте данни за наличните сертифицирани употребявани автомобили в приложенията си за анализ на цените, проучване на пазара и автоматизирано управление на наличностите.
API-то в реално време работи 24/7. Открива нови обяви в рамките на минути и следи продадените автомобили, за да разкрие реалните продажни цени. Получете достъп до пълните данни за проверката и сертификацията, без да разработвате собствени скрейпъри.
Разширете покритието на автомобилните си данни по световните пазари с нашите API за отделните платформи: