Guazi APIScraper & Parser
الوصول إلى بيانات السيارات المستعملة المعتمدة من أكبر منصة صينية عبر واجهة برمجة التطبيقات. تقارير فحص من 259 نقطة، تاريخ الحوادث، مخزون في الوقت الفعلي بدون أدوات استخراج.
واجهة برمجة تطبيقات منصة السيارات المستعملة Guazi
الوصول إلى سوق السيارات المستعملة المعتمدة الرائد في الصين من خلال واجهة برمجة التطبيقات الخاصة بنا. احصل على بيانات نظيفة من شنغهاي وبكين والمدن الصينية الكبرى لتحليل السوق وإدارة المخزون.
احصل على تنبيهات فورية لإعلانات السيارات المستعملة المعتمدة الجديدة.
تصدير يومي لجميع السيارات المعتمدة النشطة لتتبع السوق.
الوصول إلى بيانات شاملة للسيارات المستعملة: السعر، المواصفات، تقارير الفحص، حالة الاعتماد، تاريخ الحوادث، تفاصيل الضمان من كل إعلان.
الرابط الأساسي
https://{access_name}.auto-api.com/api/v2/guaziالتفويض: api_key معامل
سير العمل
/filtersالحصول على قيم الفلتر المتاحة/offersالحصول على القوائم (مع أو بدون فلاتر) - استخدم للتحميل الأولي للبياناتللتحديثات (الحفاظ على تحديث البيانات بعد التحميل الأولي):
/change_id?date=...الحصول على معرف البداية لتغذية التغييرات/changes?change_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": ["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
قائمة الإعلانات مع ترقيم الصفحات والفلاتر
المعاملات:
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- فلتر نطاق الأسعار (باليوان الصيني)
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": "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 }
}حقول البيانات:
- id - معرف قاعدة البيانات الداخلي
- inner_id - معرف الإعلان على المنصة
- url - رابط الإعلان
- title - عنوان الإعلان
- mark - ماركة السيارة
- model - موديل السيارة
- full_model - الاسم الكامل للموديل
- transmission_type - نوع ناقل الحركة (AT/MT)
- year - سنة الإنتاج
- km_age - المسافة المقطوعة بالكيلومتر
- price - السعر باليوان الصيني
- 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
الحصول على أول معرف تغيير حسب التاريخ (للاستخدام في /changes)
المعاملات:
date(مطلوب) - التاريخ بتنسيق yyyy-mm-dd
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(مطلوب) - بدءاً من أي معرف تغيير
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الاستجابة: كائن data (مثل /offers، ولكن بدون غلاف result)
بروتوكول تخزين البيانات
يتم تخزين الملفات لأكثر من 3 أيام.
جدول تسليم واجهة برمجة التطبيقات
الملفات اليومية جاهزة للتنزيل.
تكوين ملف CSV
تستخدم ملفات CSV الشريط العمودي (|) كفاصل للأعمدة.
هيكل عنوان URL:
معاملات الطلب:
access_name- access_name - معرف النطاق الفرعي المخصص لكdate- date - التاريخ المستهدف بتنسيق yyyy-mm-dd (مثال 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 عبر نقاط نهاية موثوقة ومستقرة. قم بدمج المخزون الكامل من السيارات المستعملة المعتمدة في تطبيقاتك لتحليل الأسعار، وأبحاث السوق، والإدارة التلقائية للمخزون.
تعمل واجهة API الخاصة بنا في الوقت الفعلي على مدار الساعة طوال الأسبوع، حيث تكتشف الإعلانات المعتمدة الجديدة خلال دقائق قليلة وتتتبع السيارات المباعة لتكشف عن أسعار البيع الحقيقية. احصل على بيانات الفحص والاعتماد الكاملة دون الحاجة لإنشاء أدوات استخراج مخصصة.
وسّع تغطية بيانات سياراتك عبر الأسواق العالمية باستخدام واجهاتنا البرمجية للمنصات: