Goo-net Exchange APIScraper وParser
Goo-net Exchange API: إعلانات سيارات من اليابان بأسعار FOB وتقارير فحص وصور. تابع الإعلانات والأسعار مع ملفات يومية، دون تطوير أداة جمع خاصة بك.
Goo-net Exchange API
تتيح لك واجهة واحدة الوصول إلى إعلانات الوكلاء اليابانيين على Goo-net Exchange. تحصل على بيانات السيارات مع أسعار FOB والمواصفات وتقييم الحالة والصور. ويساعدك تدفق التغييرات على تحديث قائمة السيارات في موقعك. يمكنك استخدام البيانات للبحث عن سيارات حسب طلب العملاء، وتحليل الأسعار، وإنشاء موقع يجمع الإعلانات. لا تحتاج إلى تطوير أداة لجمع البيانات أو صيانتها.
تصل إعلانات Goo-net Exchange الجديدة إلى تدفق التغييرات خلال ساعة من نشرها.
ملف واحد يومياً يضم كل الإعلانات النشطة على المنصة.
أسعار FOB والأسعار المحلية، التسجيل الأول، المسافة المقطوعة، المحرك وناقل الحركة، نظام الدفع وجهة المقود، نوع الهيكل، رموز الطراز والمحرك، حالة الإصلاح، التجهيزات، الصور، الفيديو ودرجات الحالة.
الرابط الأساسي
https://{access_name}.auto-api.com/api/v2/goonet_exchangeالتفويض: api_key معامل
سير العمل
/filtersالحصول على قيم الفلتر المتاحة/offersالحصول على القوائم (مع أو بدون فلاتر) - استخدم للتحميل الأولي للبياناتللتحديثات (الحفاظ على تحديث البيانات بعد التحميل الأولي):
/change_id?date=...الحصول على معرف البداية لتغذية التغييرات/changes?change_id=...الحصول على جميع التغييرات في قاعدة البيانات بدءاً من المعرف/offerالحصول على تفاصيل قائمة محددة بواسطة inner_idمن أين تبدأ:
1. قبل تحميل الإعلانات، استدعِ /change_id لتاريخ اليوم واحفظ المعرف (إذا أعاد 0 فأعد المحاولة لاحقاً)، ثم اجلب كل صفحات /offers.
2. أرسل طلبات دورية إلى /changes بدءاً من المعرف المحفوظ، ثم مرر next_change_id من كل استجابة للحصول على السجلات الجديدة وتحديثات الأسعار والإعلانات المحذوفة.
3. للبحث في موقعك، أرسل طلباً إلى /offers مع الفلاتر التي تحتاجها.
GET/filters
إرجاع جميع القيم الممكنة للتصفية
https://{access_name}.auto-api.com/api/v2/goonet_exchange/filters?api_key=YOUR_API_KEYالاستجابة:
{
"mark": {
"NISSAN": {
"model": ["CIMA", "ELGRAND", "FAIRLADY Z", "MARCH", "MURANO", "NOTE", "SKYLINE", "X-TRAIL"]
},
"HONDA": {
"model": ["ACCORD WAGON", "CIVIC", "FIT", "INSIGHT", "LEGEND", "N-BOX CUSTOM", "NSX", "VAMOS"]
}
},
"transmission_type": ["AT", "MT"],
"color": ["BLACK", "BLACK M", "BLUE M", "DARK BLUE", "GOLD M", "GRAY M", "GUN M", "LIGHT BLUE", "NAVY", "ORANGE", "PEARL", "PURPLE", "RED", "SILVER", "WHITE", "WINE M"],
"body_type": ["Convertible", "Coupe", "Hatchback", "Kei RV", "Kei car", "Minivan", "Pickup truck", "SUV", "Sedan", "Station wagon"],
"engine_type": ["DIESEL", "GASOLINE", "HYBRID"],
"drive_type": ["2WD", "4WD"],
"rudder": ["Left", "Right"]
}GET/offers
قائمة الإعلانات مع ترقيم الصفحات والفلاتر
المعاملات:
page(مطلوب) - رقم الصفحةmark, model- الماركة والطرازtransmission_type, color, body_type, engine_type, drive_type, rudder- ناقل الحركة واللون ونوع الهيكل والوقود ونظام الدفع وجهة المقود، دون حساسية لحالة الأحرفyear_from, year_to- نطاق سنة التسجيل الأولkm_age_from, km_age_to- نطاق المسافة المقطوعة بالكيلومترprice_from, price_to- نطاق سعر FOB بالين
https://{access_name}.auto-api.com/api/v2/goonet_exchange/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/goonet_exchange/offers?api_key=YOUR_API_KEY&page=1&mark=NISSAN&model=X-TRAIL&year_from=2015&drive_type=4WDالاستجابة:
{
"result": [
{
"id": 104,
"inner_id": "700080001830141121001",
"change_type": "added",
"created_at": "2026-09-12T23:35:41.955+03:00",
"data": {
"id": "104",
"inner_id": "700080001830141121001",
"url": "https://www.goo-net-exchange.com/usedcars/TOYOTA/LAND_CRUISER_70/700080001830141121001/",
"mark": "TOYOTA",
"model": "LAND CRUISER 70",
"configuration": "KG-HZJ76K",
"complectation": "ZX",
"year": "2002",
"price": "5862500",
"km_age": "99000",
"color": "GRAY M",
"engine_type": "DIESEL",
"body_type": "SUV",
"transmission_type": "AT",
"drive_type": "4WD",
"rudder": "Right",
"displacement": "4200",
"doors_count": "5",
"horse_power": "130",
"vin": "HZJ76K-000****",
"condition": "",
"no_accidents": true,
"owners_count": "",
"equipment": "[\"Sun / Moon Roof\", \"Air Conditioner\", \"Power Steering\", \"Power Window\", \"Navigation\", \"Alloy WheelYes\"]",
"city": "",
"region": "Fukuoka",
"address": "",
"seller_type": "",
"seller": "",
"is_dealer": true,
"salon_id": "",
"salon_is_official": "",
"full_model": "",
"title": "TOYOTA LAND CRUISER 70 ZX",
"description": "",
"offer_created": "2026-07-03",
"images": "[\"https://picture1.goo-net.com/7000800018/30141121/J/70008000183014112100100.jpg\", \"https://picture1.goo-net.com/080/0800018/J/0800018A30141121W00101.jpg\"]",
"section": "used",
"extra_prep": {
"year_month": "2002-07",
"is_price_ask": false,
"price_usd": 38155,
"domestic_price": 6000000,
"power_kw": 96.0,
"power_kw_estimated": false,
"engine_code": "1HZ",
"stock_number": "0800018A30141121W001",
"model_code": "KG-HZJ76K",
"chassis_no": "HZJ76K-000****",
"repaired": "No Repair History",
"seating_capacity": 5,
"is_new": false,
"is_certified": true,
"is_trusted_dealer": true,
"has_video": false,
"videos": [],
"evaluation": { "Engine": "Normal", "Exterior": "4", "Interior": "3", "Repaired": "No Repair" },
"updated": "2026/07/03"
}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}حقول السجل
المعرفات والروابط
- id - الرقم التسلسلي للسجل في قاعدة بياناتنا؛ للمطابقة مع المنصة استخدم inner_id
- inner_id - معرف الإعلان المكون من 21 رقماً لدى المنصة، وهو جزء من رابط الإعلان أيضاً: 700080001830141121001
- url - رابط مباشر إلى الإعلان على goo-net-exchange.com
- title - اسم السيارة في سطر واحد كما في عنوان الإعلان: TOYOTA LAND CRUISER 70 ZX
- section - قسم المنصة، دائماً used
الماركة والطراز والهيكل
- mark, model - الماركة والطراز بأحرف كبيرة كما في رابط الإعلان: TOYOTA, LAND CRUISER 70
- configuration - رمز الطراز من المصنع وفق التصنيف الياباني: KG-HZJ76K
- complectation - الفئة، أي مستوى التجهيز: ZX, 240G, X
- year - سنة التسجيل الأول في اليابان؛ وللسيارات اليابانية هي السنة المذكورة في الإعلان
- color - لون الهيكل كما كتبه الوكيل: BLACK, GRAY M, PEARL WHITE
- body_type - نوع الهيكل: SUV وMinivan وKei car وقيم أخرى من /filters
- doors_count - عدد الأبواب، غير متوفر لبعض السيارات
المحرك وناقل الحركة والدفع
- engine_type - الوقود: GASOLINE, DIESEL, HYBRID
- displacement - سعة المحرك بالسنتيمتر المكعب: 4200
- horse_power - القدرة بالحصان؛ سلسلة فارغة حين لا تتوفر بيانات لدى المنصة
- transmission_type - ناقل الحركة: AT أو MT
- drive_type - نظام الدفع: 2WD أو 4WD
- rudder - جهة المقود: Right أو Left
السعر والمسافة والحالة
- price - سعر التصدير FOB بالين؛ -1 إذا كان السعر عند الطلب
- km_age - قراءة العداد بالكيلومتر: 99000
- no_accidents - true تعني حالة No Repair History: لم يُصلح الهيكل بعد حادث
- condition - ما أعلنه الوكيل عن السيارة: مالك واحد، مقصورة خالية من التدخين، سجلات صيانة محفوظة؛ قد يكون فارغاً
- owners_count - 1 عند وجود علامة One Owner، وإلا فارغ
- vin - رقم الهيكل مع حجب المنصة لآخر أربعة أرقام: HZJ76K-000****
- equipment - قائمة التجهيزات كمصفوفة JSON داخل سلسلة نصية: تكييف، فتحة سقف، ملاحة وغيرها
البائع والصور والتواريخ
- is_dealer - دائماً true: لا يبيع على المنصة سوى الوكلاء
- region - المحافظة التي توجد فيها السيارة: Fukuoka, Hyogo, Gunma
- images - روابط الصور كمصفوفة JSON داخل سلسلة نصية، غالباً عشرات اللقطات
- offer_created - تاريخ آخر تحديث للإعلان من الوكيل
- city, address, seller_type, seller, salon_id, salon_is_official, full_model, description - لا تكشف المنصة عن هذه البيانات، وتصل الحقول فارغة
- extra_prep - كائن متداخل يضم بقية البيانات، موصوف أدناه؛ ما لا تملكه المنصة يصل null أو فارغاً
داخل extra_prep
الأسعار
- is_price_ask - true حين يكون السعر عند الطلب؛ عندها price يساوي -1 وprice_usd فارغ
- price_usd - سعر FOB نفسه محولاً إلى الدولار من المنصة: 38155
- domestic_price - السعر الذي تُعرض به السيارة نفسها للمشترين داخل اليابان، بالين: 6000000
البيانات التقنية والرموز
- year_month - شهر التسجيل الأول: 2002-07
- power_kw - قدرة المحرك بالكيلوواط؛ null إذا لم تتوفر البيانات
- power_kw_estimated - true حين حُسبت قيمة الكيلوواط بالتحويل من الحصان
- engine_code - رمز المحرك من المصنع: 1HZ, 2AZ-FE
- model_code - رمز الطراز نفسه الموجود في configuration
- chassis_no - رقم الهيكل المحجوب نفسه الموجود في vin
- stock_number - رقم السيارة في مخزون الوكيل
- seating_capacity - عدد المقاعد وفق المنصة
الحالة والثقة
- repaired - حالة الإصلاح بصياغة المنصة: No Repair History أو Yes
- evaluation - درجات تقرير الفحص: المقصورة والهيكل الخارجي من 1 إلى 5 وحكم المحرك وحكم الإصلاح؛ null دون تقرير
- is_certified - true حين يُرفق تقرير فحص بالإعلان
- is_trusted_dealer - true حين يحمل البائع حالة Trusted Dealer لدى المنصة
- is_new - true للإعلانات الجديدة التي تحمل العلامة NEW
الفيديو والتواريخ
- has_video - true حين صوّر الوكيل السيارة بالفيديو
- videos - روابط مباشرة إلى مقاطع mp4، وقائمة فارغة دون فيديو
- updated - تاريخ التحديث كما سجلته المنصة: 2026/07/03
GET/change_id
الحصول على أول معرف تغيير حسب التاريخ (للاستخدام في /changes)
المعاملات:
date(مطلوب) - التاريخ بتنسيق yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/goonet_exchange/change_id?api_key=YOUR_API_KEY&date=2026-09-14الاستجابة:
{ "change_id": 61537 }استخدم القيمة المرجعة كمعامل change_id في /changes
GET/changes
تغذية التغييرات (مضاف/معدل/محذوف)
المعاملات:
change_id(مطلوب) - بدءاً من أي معرف تغيير
https://{access_name}.auto-api.com/api/v2/goonet_exchange/changes?api_key=YOUR_API_KEY&change_id=61537الاستجابة:
{
"result": [
{
"id": 61537,
"inner_id": "700104006720070608004",
"change_type": "added", // added - new listing
"created_at": "2026-09-14T09:03:12.118+03:00",
"data": { ... } // full listing data
},
{
"id": 61538,
"inner_id": "700080001830141121001",
"change_type": "changed", // changed - price update, JPY
"created_at": "2026-09-14T09:47:55.604+03:00",
"data": { "new_price": 5790000 }
},
{
"id": 61539,
"inner_id": "700090363730150113003",
"change_type": "removed", // removed - listing deleted
"created_at": "2026-09-14T11:20:08.976+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 61537, "next_change_id": 61540, "limit": 20 }
}GET/offer
إعلان فردي بواسطة inner_id
المعاملات:
inner_id(مطلوب)
https://{access_name}.auto-api.com/api/v2/goonet_exchange/offer?api_key=YOUR_API_KEY&inner_id=700080001830141121001الاستجابة: كائن data (مثل /offers، ولكن بدون غلاف result)
مدة الاحتفاظ
تبقى الملفات متاحة لمدة 3 أيام على الأقل
التوفر
ملفات جديدة كل صباح
صيغة CSV
أعمدة CSV مفصولة بالرمز العمودي (|)
بنية الرابط:
المعاملات:
access_name- نطاقك الفرعي الشخصيdate- تاريخ التصدير بصيغة yyyy-mm-dd، مثلاً 2026-09-13file_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'Goo-net Exchange هي واجهة التصدير لمجموعة Proto Corporation التي تدير أيضاً goo-net.com، السوق اليابانية المحلية. يعرض فيها وكلاء من جميع أنحاء اليابان سيارات للمشترين في الخارج، من سيارات الكي والميني فان إلى سيارات الدفع الرباعي والسيارات الرياضية. الموقع باللغة الإنجليزية، والأسعار معروضة بالين والدولار.
السمة المميزة هي سعر FOB: فهو يشمل مسبقاً التسليم إلى ميناء ياباني والشحن على متن السفينة. يتضمن كل سجل شهر التسجيل الأول والمسافة المقطوعة وسعة المحرك وناقل الحركة ونظام الدفع وجهة المقود وحالة الإصلاح بعد الحوادث وقائمة التجهيزات. ويضيف بعض الوكلاء فيديو، وتأتي السيارات المرفقة بتقرير فحص مع درجات للمقصورة والهيكل الخارجي.
إذا كنت تستورد السيارات من اليابان، تساعدك هذه البيانات على توفير الوقت عند اختيار السيارات. تصلك الإعلانات الجديدة خلال ساعة من نشرها. وتصلك تحديثات الأسعار عبر تدفق التغييرات نفسه. يمكنك مقارنة سعر FOB بالسعر في السوق اليابانية المحلية إذا أدرج الوكيل السعرين، والاطلاع على قدرة المحرك بالكيلوواط إذا كانت متاحة. وتساعدك بيانات الإصلاح وتقارير الفحص المتاحة على استبعاد السيارات ذات المشكلات قبل التواصل مع الوكيل. سجلات السيارات مع الصور جاهزة للنشر على موقعك أو في كتالوجك.
تعمل واجهة Goo-net Exchange API على مدار الساعة. تدخل الإعلانات الجديدة وتغييرات الأسعار وعمليات الحذف إلى التدفق تلقائياً. كل شيء متاح عبر REST، ولا حاجة إلى أداة جمع خاصة بك.
وسّع تغطية بيانات سياراتك عبر الأسواق العالمية باستخدام واجهاتنا البرمجية للمنصات: