Carsensor APIScraper وParser
Carsensor API: أسعار الوكلاء اليابانيين مع مصاريف التسجيل وبدونها، والمسافة المقطوعة والفحص والمواصفات والصور. تدفق أحداث لكل سيارة، والمخزون الكامل يومياً.
Carsensor API
نتولى نحن جمع بيانات Carsensor وتحليلها، وتحصل أنت على إعلانات الوكلاء اليابانيين جاهزة عبر API. يتضمن السجل سعر السيارة والمبلغ الإجمالي لدى الوكيل، والمسافة المقطوعة، والمواصفات، وبيانات الفحص، والصور، ويبلغك تدفق التغييرات بالإعلانات الجديدة، وبالسعر الجديد للسيارة، وبسحب السيارات من البيع.
يبلغك تدفق التغييرات بكل إعلان جديد على Carsensor، وبكل سعر جديد، وبكل سيارة تُسحب من البيع.
ملف يومي يضم مخزون Carsensor الحالي كاملاً.
سعر السيارة والمبلغ الإجمالي لدى الوكيل، سنة التسجيل، المسافة المقطوعة، رمز الطراز ورمز المحرك، القدرة، ناقل الحركة ونظام الدفع وجهة المقود، علامات الحالة والإصلاح، ورقة الفحص، التجهيزات، الوكيل والصور.
الرابط الأساسي
https://{access_name}.auto-api.com/api/v2/carsensorالتفويض: api_key معامل
سير العمل
/filtersالحصول على قيم الفلتر المتاحة/offersالحصول على القوائم (مع أو بدون فلاتر) - استخدم للتحميل الأولي للبياناتللتحديثات (الحفاظ على تحديث البيانات بعد التحميل الأولي):
/change_id?date=...الحصول على معرف البداية لتغذية التغييرات/changes?change_id=...الحصول على جميع التغييرات في قاعدة البيانات بدءاً من المعرف/offerالحصول على تفاصيل قائمة محددة بواسطة inner_idمن أين تبدأ:
1. قبل التحميل الأول، استدعِ /change_id بتاريخ اليوم واحفظ القيمة المُعادة؛ وإذا أعاد 0 فأعد الطلب بعد قليل. ثم حمّل /offers صفحةً بعد صفحة حتى النهاية.
2. بعد ذلك اقرأ /changes بدءاً من هذا المعرف، ومرر في كل مرة next_change_id من الاستجابة: هكذا تصلك السيارات الجديدة والأسعار الجديدة والإعلانات المحذوفة. وإذا وصل next_change_id بقيمة null فلا توجد أحداث جديدة بعد: أعد الطلب لاحقاً بالمعرف نفسه.
3. للبحث وفق شروطك، استدعِ /offers مع الفلاتر التي تحتاجها.
GET/filters
إرجاع جميع القيم الممكنة للتصفية
https://{access_name}.auto-api.com/api/v2/carsensor/filters?api_key=YOUR_API_KEYالاستجابة:
{
"mark": {
"Toyota": {
"model": ["Alphard", "Aqua", "Crown", "Harrier", "Hiace Van", "Land Cruiser Prado", "Noah", "Prius", "Sienta", "Voxy"]
},
"Honda": {
"model": ["Fit", "Freed", "N-BOX", "Vezel"]
}
},
"transmission_type": ["Automatic", "CVT", "Manual", "Other"],
"color": ["Black", "Blue", "Brown", "Gold", "Gray", "Green", "Navy", "Orange", "Other", "Pearl", "Pink", "Purple", "Red", "Silver", "White", "Yellow"],
"body_type": ["Bus", "Camper", "Convertible", "Coupe", "Hatchback", "Minivan", "Other", "Pickup truck", "SUV", "Sedan", "Station wagon", "Truck"],
"engine_type": ["Diesel", "Electric", "Gasoline", "Hybrid", "Plug-in hybrid"],
"drive_type": ["2WD", "4WD"],
"rudder": ["Left", "Right", "Unknown"]
}GET/offers
قائمة الإعلانات مع ترقيم الصفحات والفلاتر
المعاملات:
page(مطلوب) - رقم الصفحةmark, model- الماركة والطراز كما يُكتبان في /filterstransmission_type, color, body_type, engine_type, drive_type, rudder- ناقل الحركة واللون ونوع الهيكل والوقود ونظام الدفع وجهة المقود، دون حساسية لحالة الأحرفyear_from, year_to- نطاق سنة التسجيل الأولkm_age_from, km_age_to- نطاق المسافة المقطوعة بالكيلومترprice_from, price_to- نطاق سعر السيارة بالين
https://{access_name}.auto-api.com/api/v2/carsensor/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/carsensor/offers?api_key=YOUR_API_KEY&page=1&mark=Honda&model=Freed&year_from=2020&km_age_to=50000&engine_type=Gasolineالاستجابة:
{
"result": [
{
"id": 3,
"inner_id": "AU7363661281",
"change_type": "added",
"created_at": "2026-09-29T01:24:02.000+03:00",
"data": {
"id": "3",
"inner_id": "AU7363661281",
"url": "https://www.carsensor.net/usedcar/detail/AU7363661281/index.html",
"mark": "Honda",
"model": "Freed",
"generation": "2025.07 -",
"configuration": "5BA-GT1",
"complectation": "1.5 エアー EX",
"year": "2025",
"price": "3090000",
"km_age": "9000",
"color": "Navy",
"engine_type": "Gasoline",
"body_type": "Minivan",
"transmission_type": "CVT",
"drive_type": "2WD",
"rudder": "Right",
"displacement": "1500",
"doors_count": "5",
"horse_power": "118",
"condition": "Non-smoking car",
"no_accidents": true,
"owners_count": "",
"equipment": "[\"Power steering\", \"ABS\", \"Automatic emergency braking\", \"Adaptive cruise control\", \"Lane keeping assist\", \"Camera: rear\", \"Electronic stability control\"]",
"region": "Saitama",
"city": "幸手市",
"address": "埼玉県幸手市北２－６－１６",
"seller": "ネクステージ 幸手店",
"seller_url": "https://www.carsensor.net/shop/saitama/206339416/",
"salon_id": "206339416",
"section": "used",
"title": "フリード 1.5 エアー EX 両側電動スライドドア 純正11.4型ナビ バックカメラ 衝突軽減",
"offer_created": "2026-09-28",
"images": "[\"https://ccsrpcma.carsensor.net/CSphoto/bkkn/308/423/UZ0054308423/UZ0054308423_001.JPG?ver=detail001&impolicy=car_002\", \"https://ccsrpcml.carsensor.net/CSphoto/ml/308/423/UZ0054308423/UZ0054308423_1_001.jpg?ver=detail001&impolicy=car_002\"]",
"extra_prep": {
"total_price": 3212000,
"plan_prices": { "A": 3228000, "B": 3229000 },
"is_price_ask": false,
"monthly_loan": 25600,
"monthly_loan_type": "regular",
"is_mileage_unknown": false,
"is_mileage_tampered": false,
"is_meter_replaced": false,
"year_raw": "2025(R07)",
"chassis_no_tail": "064",
"seats": 6,
"power_kw": 86.79,
"power_kw_estimated": true,
"engine_code": "L15D",
"displacement_exact": 1496,
"catalog_path": "honda/freed/F003/M003G013",
"maker_code": "HO",
"model_code_site": "S083",
"is_new": true,
"is_maker_certified": false
// ... other extra_prep fields, including the ais inspection sheet
}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}حقول السجل
- id - رقم السجل في قاعدة بياناتنا؛ للربط بالإعلان على المنصة استخدم inner_id
- inner_id - معرف الإعلان على Carsensor، وهو جزء من رابط الإعلان أيضاً: AU7363661281
- url - رابط الإعلان على carsensor.net
- title - عنوان الإعلان كما كتبه الوكيل
- section - القسم: used للسيارات المستعملة، وnew للسيارات الجديدة
- mark, model - الماركة والطراز، مثل Honda وFreed
- generation - فترة إنتاج هذا الإصدار من الطراز بصيغة 2017.04 - 2018.03؛ وإذا كان الطراز لا يزال قيد الإنتاج فلا يوجد تاريخ نهاية
- configuration - رمز الطراز كما في وثائق التسجيل اليابانية، مثل 5BA-GT1
- complectation - الفئة كما ذكرها الوكيل
- year - سنة التسجيل الأول للسيارة؛ وفي سيارات الاستيراد الموازي تذكر المنصة سنة الصنع
- color - لون الهيكل، والقيم من /filters
- body_type - نوع الهيكل، والقيم من /filters
- doors_count - عدد الأبواب
- engine_type - نوع الوقود، والقيم من /filters
- displacement - سعة المحرك بالسنتيمتر المكعب
- horse_power - القدرة المعلنة من المصنع بالحصان؛ في السيارة الهجينة تُحتسب قدرة محرك الاحتراق الداخلي فقط، وفي السيارة الكهربائية تُذكر قدرة المحرك الكهربائي؛ وإذا لم تتوفر البيانات يبقى الحقل فارغاً
- transmission_type - نوع ناقل الحركة: أوتوماتيكي أو يدوي أو CVT أو غير ذلك
- drive_type - 4WD أو 2WD؛ ولمعرفة العجلات الدافعة في 2WD راجع drive_catalog
- rudder - جهة المقود
- price - سعر السيارة بالين شاملاً ضريبة الاستهلاك اليابانية، أما مصاريف التسجيل فتُحسب منفصلة؛ -1 إذا كان السعر عند الطلب
- km_age - المسافة المقطوعة بالكيلومتر كما تقرّبها المنصة، عادةً إلى أقرب ألف؛ ويبقى الحقل فارغاً إذا كانت المسافة مجهولة أو تم التلاعب بالعداد
- no_accidents - true تعني أن الهيكل الأساسي لم يخضع لإصلاح أو استبدال؛ وfalse تعني أنه خضع لذلك
- condition - ملاحظات الوكيل كقائمة مفصولة بفواصل، مثل مالك واحد، مقصورة خالية من التدخين، دفتر صيانة
- owners_count - يساوي 1 إذا ذكر الوكيل أن للسيارة مالكاً واحداً؛ وفي غير ذلك يبقى فارغاً
- equipment - قائمة التجهيزات كمصفوفة JSON داخل سلسلة نصية
- seller - اسم الوكيل
- seller_url - رابط صفحة الوكيل على carsensor.net
- salon_id - معرف الوكيل لدى Carsensor
- region - المحافظة التي توجد فيها السيارة
- city - المدينة أو المنطقة
- address - عنوان الوكيل
- images - روابط الصور كمصفوفة JSON داخل سلسلة نصية، ولدى كثير من السيارات عشرات اللقطات
- offer_created - تاريخ ظهور الإعلان وفق علامة NEW؛ ويبقى فارغاً إذا كان التاريخ غير معروف
- extra_prep - كائن متداخل يضم بيانات إضافية، موصوف أدناه؛ وإذا لم تتوفر قيمة يصل null
داخل extra_prep
- total_price - المبلغ الإجمالي المستحق بالين: سعر السيارة مع الرسوم الإلزامية للتسجيل عند شرائها من هذا الوكيل وتسجيلها في منطقته
- plan_prices - المبلغ الإجمالي المستحق في باقتي الوكيل A وB، مثل باقة بضمان ممتد؛ ولا يتوفر لكل السيارات
- is_price_ask - true حين لا يذكر الوكيل السعر، وعندها price يساوي -1
- monthly_loan - قيمة القسط الشهري لتمويل الوكيل بالين
- monthly_loan_type - نوع التمويل: regular للتمويل العادي، وresidual للتمويل بدفعة متبقية في نهايته
- mileage_raw - المسافة المقطوعة كما كُتبت في الإعلان مع ملاحظاتها
- is_mileage_unknown - true حين تكون المسافة الفعلية مجهولة
- is_mileage_tampered - true حين يكون التلاعب بعداد المسافات مؤكداً
- is_meter_replaced - true حين يكون عداد المسافات قد استُبدل
- year_raw - السنة كما في الإعلان مع رمز الحقبة اليابانية: 2025(R07)
- shaken - تاريخ انتهاء صلاحية الفحص الفني الياباني (السنة والشهر)، أو ملاحظة تبين هل سيجريه الوكيل عند البيع
- warranty - هل يتوفر ضمان
- maintenance - الصيانة الإلزامية قبل البيع: مشمولة في السعر، أو بمقابل منفصل، أو لا تُجرى
- recycle_fee - حالة رسوم إعادة التدوير اليابانية: هل دُفعت وهل هي مشمولة في السعر
- transmission_raw - التسمية الأصلية لناقل الحركة: موضع ذراع التبديل، وعدد السرعات، وهل يوجد وضع يدوي
- color_name - اللون كما وصفه الوكيل
- color_factory - اسم اللون من المصنع
- chassis_no_tail - آخر ثلاثة أرقام من رقم الهيكل؛ ولا ينشر Carsensor الرقم كاملاً
- seats - عدد المقاعد
- fuel - الوقود الذي توصي به الشركة المصنعة: بنزين عادي أو بنزين عالي الأوكتان أو ديزل
- drive_catalog - نظام الدفع وفق مواصفات المصنع، مثل FF (العجلات الأمامية) أو FR (الخلفية) أو 4WD (العجلات الأربع)
- power_kw - القدرة من horse_power محولة إلى الكيلوواط
- power_kw_estimated - true حين حُسبت قيمة الكيلوواط بالتحويل من الحصان
- engine_kind - بنية المحرك: عدد الأسطوانات وترتيبها ونوع آلية الصمامات؛ وفي السيارة الكهربائية يُذكر المحرك الكهربائي
- engine_code - رمز المحرك: L15D
- displacement_exact - سعة المحرك وفق بيانات المصنع بدقة تصل إلى السنتيمتر المكعب: 1496
- grade_name - الاسم الكامل للفئة وفق بيانات المصنع
- catalog_path - معرف الفئة على carsensor.net، وهو واحد لكل السيارات من الفئة نفسها
- maker_code - رمز الماركة داخل Carsensor
- model_code_site - رمز الطراز داخل Carsensor
- is_new - true عند وجود علامة NEW: أي أن الإعلان ظهر أو أُعيد نشره خلال الأسبوع الأخير
- labels - الشارات الظاهرة على الإعلان، مثل ضمان الوكيل، وتصوير 360°، والاستشارة عبر الإنترنت، وتقرير التقييم
- is_maker_certified - true للسيارات المعتمدة من الشركة المصنعة
- evaluation - نتيجة فحص خبير التقييم: من أجرى الفحص، والدرجة العامة، والتاريخ؛ والدرجة R تُمنح للسيارات التي أُصلح هيكلها الأساسي
- ais - ورقة الفحص المفصلة من Carsensor: الدرجة النهائية، ودرجات المقصورة والهيكل الخارجي بالحروف، ورمز الطراز، وقراءة العداد يوم الفحص، وهل أُعيد طلاء السيارة بالكامل وهل استُبدل العداد، وقائمة العيوب، ورابط صورة تبين مواضع الأضرار
GET/change_id
الحصول على أول معرف تغيير حسب التاريخ (للاستخدام في /changes)
المعاملات:
date(مطلوب) - التاريخ بتنسيق yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/carsensor/change_id?api_key=YOUR_API_KEY&date=2026-09-29الاستجابة:
{ "change_id": 1254 }استخدم القيمة المرجعة كمعامل change_id في /changes
GET/changes
تغذية التغييرات (مضاف/معدل/محذوف)
المعاملات:
change_id(مطلوب) - بدءاً من أي معرف تغيير
https://{access_name}.auto-api.com/api/v2/carsensor/changes?api_key=YOUR_API_KEY&change_id=1254الاستجابة:
{
"result": [
{
"id": 1254,
"inner_id": "AU7305608350",
"change_type": "added", // added - new listing
"created_at": "2026-09-29T19:12:40.512+03:00",
"data": { ... } // full listing data
},
{
"id": 1255,
"inner_id": "AU7363661281",
"change_type": "changed", // changed - new car price, JPY
"created_at": "2026-09-29T20:05:17.208+03:00",
"data": { "new_price": 2990000 }
},
{
"id": 1256,
"inner_id": "AU6927774389",
"change_type": "removed", // removed - listing deleted
"created_at": "2026-09-29T21:48:02.331+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 1254, "next_change_id": 1257, "limit": 20 }
}GET/offer
إعلان فردي بواسطة inner_id
المعاملات:
inner_id(مطلوب)
https://{access_name}.auto-api.com/api/v2/carsensor/offer?api_key=YOUR_API_KEY&inner_id=AU7363661281الاستجابة: كائن data (مثل /offers، ولكن بدون غلاف result)
مدة الاحتفاظ
تبقى الملفات متاحة لمدة 3 أيام على الأقل
التوفر
ملفات جديدة كل صباح
صيغة CSV
أعمدة CSV مفصولة بالرمز العمودي (|)
بنية الرابط:
المعاملات:
access_name- نطاقك الفرعي الشخصيdate- تاريخ التصدير بصيغة yyyy-mm-dd، مثلاً 2026-09-29file_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'يعود موقع Carsensor (carsensor.net) إلى شركة Recruit اليابانية، وهو من أكبر مواقع السيارات المستعملة في اليابان. لا ينشر الإعلانات فيه إلا الوكلاء، من المعارض الصغيرة إلى صالات العرض الرسمية للماركات، ويُباع فيه كل شيء تقريباً، بما في ذلك سيارات الكي والشاحنات وعربات التخييم.
الأسعار على Carsensor بالين، ويظهر سعر السيارة منفصلاً عن المبلغ الإجمالي الذي يشمل مصاريف التسجيل لدى الوكيل. ويبين الإعلان ما إذا كانت أجزاء الهيكل الأساسي قد أُصلحت أو استُبدلت، وهل يوجد ضمان، وحتى أي شهر يسري الفحص الفني. وتخضع بعض السيارات لفحص يجريه خبير تقييم من Carsensor، وعندها تُرفق بالإعلان ورقة فيها الدرجات والعيوب.
تساعد هذه البيانات المستورد على إيجاد الفئة المطلوبة بسرعة لدى الوكلاء في كل أنحاء اليابان، وعلى ألا تفوته الإعلانات الجديدة. ومن البيانات نفسها يتضح كم يكلف الطراز في السوق اليابانية وكيف يتغير سعره، ويسهّل رمز الطراز ومواصفات المحرك تقدير الرسوم الجمركية ورسوم الاستيراد مسبقاً.
تصل عبر /changes الإعلانات الجديدة، والأسعار الجديدة للسيارات، وعمليات السحب من البيع. ولا حاجة إلى أداة جمع خاصة بك.
وسّع تغطية بيانات سياراتك عبر الأسواق العالمية باستخدام واجهاتنا البرمجية للمنصات: