Guazi APIПарсер и скрапер
API Guazi (Гуази) - рынок б/у авто Китая. Парсер объявлений, отчеты проверки (259 пунктов), история ДТП и цены. Экспорт в CSV, JSON, Excel.
API Guazi (Гуази)
Получите доступ к Guazi - крупнейшему рынку сертифицированных б/у авто Китая. Парсер данных из Шанхая, Пекина и крупных городов для анализа рынка подержанных автомобилей.
Получайте моментальные уведомления о новых сертифицированных авто.
Ежедневный экспорт всех активных сертифицированных машин.
Доступ к исчерпывающим данным: цена, спецификации, отчеты осмотра, сертификация, история ДТП и гарантии из каждого объявления.
Базовый URL
https://{access_name}.auto-api.com/api/v2/guaziАвторизация: api_key параметр
Алгоритм работы
/filtersполучить справочники и значения фильтров/offersполучить список объявлений (с фильтрами или без) - для первичной загрузкиПоддержание актуальности (после первичной загрузки):
/change_id?date=...получить стартовый ID для потока изменений/changes?change_id=...получить поток изменений (дельту) начиная с указанного ID/offerполучить детальные данные объявления по inner_idРекомендуемый способ интеграции:
1. Используйте /offers для выгрузки всех данных.
2. Периодически вызывайте /changes для получения обновлений.
3. Для вывода на сайте используйте /offers.
GET/filters
Справочники и возможные значения для фильтрации
https://{access_name}.auto-api.com/api/v2/guazi/filters?api_key=YOUR_API_KEYОтвет:
{
"mark": {
"BMW": { "model": ["X5", "X3"] },
"Audi": { "model": ["A4", "Q7"] }
},
"transmission_type": ["Механика", "Автомат"],
"color": ["Зеленый", "Фиолетовый", "Красный", "Белый", "Шампань", "Серебристый", "Черный", "Серый", "Синий", "Желтый"],
"rudder": ["Левый"],
"body_type": ["Седан", "Универсал", "Внедорожник", "Кабриолет", "Автобус", "Спорткар", "Хэтчбек", "Пикап", "Кроссовер", "Грузовик"],
"engine_type": ["Дизель", "Подключаемый гибрид", "Гибрид", "Бензин", "Электро", "Последовательный гибрид"],
"drive_type": ["Полный", "Передний"]
}GET/offers
Поиск объявлений с пагинацией и фильтрами
Параметры:
page(обязательно) - номер страницыmark, model, transmission_type, color, rudder, body_type, engine_type, drive_type- фильтры (регистр не важен)year_from, year_to- фильтр по годамkm_age_from, km_age_to- фильтр по пробегуprice_from, price_to- фильтр по цене (в 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Ответ:
{
"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": "Автомат",
"year": 2016,
"km_age": 112700,
"price": 5011,
"color": "Черный",
"displacement": 1.5,
"doors_count": 5,
"region": "China",
"city": "Binzhou",
"address": "Binzhou, Shandong",
"section": "used",
"rudder": "Левый",
"body_type": "Внедорожник",
"engine_type": "Бензин",
"equipment": ["Heated Seats", "Keyless Entry", "Backup Camera"],
"images": ["https://global-image-pub.guazistatic.com/qnbdp7206x..."],
"extra": {"inspection_score": 85},
"drive_type": "Передний",
"productionYearMonth": "2016-03",
"licenseDate": "2016-05-20"
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Поля данных:
- id - внутренний ID базы данных
- inner_id - ID объявления на платформе
- url - ссылка на объявление
- title - заголовок
- mark - марка
- model - модель
- full_model - полное название модели
- transmission_type - тип КПП (AT/MT)
- year - год выпуска
- km_age - пробег (км)
- price - цена в CNY
- color - цвет
- displacement - объем двигателя
- doors_count - количество дверей
- region - регион
- city - город
- address - адрес
- section - раздел
- rudder - руль (левый/правый)
- body_type - кузов
- engine_type - тип двигателя
- equipment - список оборудования
- images - список фото
- drive_type - привод (FWD/RWD/AWD)
- productionYearMonth - дата производства (ГГГГ-ММ)
- licenseDate - дата регистрации
GET/change_id
Получить первый ID изменения на конкретную дату (для /changes)
Параметры:
date(обязательно) - дата в формате гггг-мм-дд
https://{access_name}.auto-api.com/api/v2/guazi/change_id?api_key=YOUR_API_KEY&date=2025-01-15Ответ:
{ "change_id": 6718293 }Используйте это значение как параметр change_id в /changes
GET/changes
Поток изменений (новые/измененные/удаленные)
Параметры:
change_id(обязательно) - начиная с какого change_id
https://{access_name}.auto-api.com/api/v2/guazi/changes?api_key=YOUR_API_KEY&change_id=1Ответ:
{
"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
Карточка объявления по inner_id
Параметры:
inner_id(обязательно)
https://{access_name}.auto-api.com/api/v2/guazi/offer?api_key=YOUR_API_KEY&inner_id=152471636Ответ: объект данных (как в /offers, но без обертки result)
Хранение данных
Файлы хранятся 3+ дней.
График обновлений
Ежедневные файлы готовы к скачиванию.
Настройка CSV
В CSV-файлах используется разделитель «|» (pipe).
Структура URL:
Параметры запроса:
access_name- access_name - ваш идентификатор поддоменаdate- date - дата в формате гггг-мм-дд (напр. 2025-09-22)file_name- 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
Пример запроса 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 через стабильные эндпоинты. Интегрируйте инвентарь сертифицированных авто в ваши приложения для ценовой аналитики, исследования рынка и автоматизации управления стоком.
Real-time API работает 24/7, обнаруживая новые объявления за минуты и отслеживая продажи для фиксации реальных цен сделок. Получите доступ к полным данным осмотра без создания собственных скраперов.
Расширьте охват автомобильных данных по мировым рынкам с помощью наших API платформ: