AUTO-API.COM
Лого на Guazi.com

Guazi APIScraper & Parser

API за сертифицирани употребявани автомобили от най-голямата платформа в Китай: 259-точкова проверка, история на произшествията, наличности в реално време, без скрейпъри.

Официални SDK библиотеки

Отворен код, типизирани отговори и никакви настройки освен вашия API ключ. Изберете език и започнете да извличате обяви от Guazi.

Guazi API

Получете достъп до водещия онлайн пазар за сертифицирани употребявани автомобили в Китай чрез нашето API. Извличайте изчистени данни от Шанхай, Пекин и големите китайски градове за анализ на пазара и управление на наличностите.

API

Получавайте незабавни известия за нови обяви за сертифицирани автомобили.

Ежедневни експорти

Ежедневен експорт с всички налични сертифицирани автомобили за проследяване на пазара.

Пълни данни

Получете достъп до изчерпателни данни за употребявани автомобили: цена, характеристики, доклади от проверката, статус на сертификацията, история на произшествията, данни за гаранцията от всяка обява.

Получете достъп до APIДостъпът се предоставя до 2 минути

Обявата идва с цени по пунктове на изпращане, резултатите от проверката от Guazi, характеристиките на версията и оборудването.

Базов URL

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

Оторизация: api_key параметър

Ред на работа

1
/filtersполучаване на наличните стойности на филтрите
2

Първоначално зареждане:

/change_id?date=...получаване на началното ID за потока от промени
/offersполучаване на всички обяви страница по страница
3
/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID
4
/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 - марка и модел, изписани точно както във /filters
  • transmission_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 адреса:

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

Параметри на заявката:

  • 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.com

Guazi е най-голямата платформа за сертифицирани употребявани автомобили в Китай. Създадена, за да внесе прозрачност на пазара на употребявани автомобили, тя свързва купувачите с качествени употребявани автомобили в големите градове. Всеки автомобил преминава професионална 259-точкова проверка, преди да бъде обявен за продажба.

Всяка обява съдържа подробни доклади от проверката, пълна история на произшествията, професионални снимки и прозрачни цени. Процесът на сертификация на Guazi осигурява на купувачите точна информация за автомобила, включително скрити проблеми и история на ремонтите.

Платформата предлага възможности за финансиране, удължени гаранции и следпродажбено обслужване. Разширените филтри за търсене помагат на купувачите да намират автомобили по марка, модел, година, диапазон на цената, пробег и ниво на сертификация. Обновяванията на наличностите в реално време поддържат обявите актуални.

Нашето API доставя структурирани данни от платформата Guazi чрез стабилни крайни точки. Интегрирайте данни за наличните сертифицирани употребявани автомобили в приложенията си за анализ на цените, проучване на пазара и автоматизирано управление на наличностите.

API-то в реално време работи 24/7. Открива нови обяви в рамките на минути и следи продадените автомобили, за да разкрие реалните продажни цени. Получете достъп до пълните данни за проверката и сертификацията, без да разработвате собствени скрейпъри.

Отговор до 2 мин