AutoScout24 APIScraper & Parser
AutoScout24 API - access AutoScout24 data: prices, specs, photos, history. REST API and daily exports of European cars for your business needs.
واجهة برمجية لمنصة السيارات الأوروبية
بيانات سوق السيارات الأوروبي بواجهتنا. بيانات مركبات منظمة للتحليل وتقييم السوق وقرارات الشراء.
تراقب واجهة AutoScout24 البرمجية لدينا وتقدم إعلانات المركبات الجديدة في اللحظة التي تظهر فيها على المنصة.
احصل على تصدير يومي كامل لجميع الإعلانات الحالية لتحليل السوق.
توفر واجهتنا البرمجية كل التفاصيل من AutoScout24: السعر، الأميال، السنة، العلامة التجارية، الطراز، المواصفات الفنية، التجهيزات، تقارير الحالة، وتاريخ المركبة.
الرابط الأساسي
https://{access_name}.auto-api.com/api/v2/autoscout24التفويض: 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/autoscout24/filters?api_key=YOUR_API_KEYالاستجابة:
{
"mark": {
"BMW": {
"model": {
"3 Series": {
"configuration": {
"320d": { "complectation": ["Sport Line", "Luxury Line", "M Sport"] }
}
}
}
},
"Mercedes-Benz": {
"model": {
"C-Class": {
"configuration": {
"C200": { "complectation": ["Avantgarde", "AMG Line"] }
}
}
}
}
},
"transmission_type": ["MT", "AT"],
"color": ["Champagne", "Black", "Purple", "Silver", "Red", "Gray", "Blue", "White", "Green", "Yellow"],
"body_type": ["Pick Up", "Sedan", "Sports Car", "Crossover", "Bus", "Hatchback", "Station Wagon", "Convertible", "SUV", "Truck"],
"engine_type": ["PHEV", "Diesel", "BEV", "Gasoline", "HEV", "REEV"]
}GET/offers
قائمة الإعلانات مع ترقيم الصفحات والفلاتر
المعاملات:
page(مطلوب) - رقم الصفحةmark, model, configuration, complectation- فلاتر (غير حساس لحالة الأحرف)transmission_type, color, body_type, engine_type- فلاتر (غير حساس لحالة الأحرف)year_from, year_to- فلتر نطاق السنواتkm_age_from, km_age_to- فلتر نطاق المسافة المقطوعةprice_from, price_to- فلتر نطاق الأسعار (باليورو)
https://{access_name}.auto-api.com/api/v2/autoscout24/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/autoscout24/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&color=blackالاستجابة:
{
"result": [
{
"id": 4695867,
"inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
"change_type": "added",
"created_at": "2025-05-27T00:23:45.196Z",
"data": {
"id": 4695867,
"inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
"url": "https://www.autoscout24.com/offers/toyota-yaris-...",
"mark": "Toyota",
"model": "Yaris",
"configuration": "1.4 D-4D",
"complectation": "Sol",
"year": 2006,
"color": "Black",
"price_eur": 3490,
"km_age": 240000,
"engine_type": "Diesel",
"transmission_type": "MT",
"body_type": "Hatchback",
"address": "Roma - Rm",
"seller_type": "dealer",
"is_dealer": true,
"section": "used",
"seller": "Spazio Auto Srl",
"seller_id": "17358964",
"description": "Toyota Yaris in excellent condition...",
"displacement": 1.4,
"horse_power": 90,
"offer_created": "2025-05-27",
"doors_count": 5,
"num_seats": 5,
"first_registration": "12/2006",
"images": ["https://prod.pictures.autoscout24.net/..."],
"seller_phones": ["+390624416455"],
"extra": {}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}حقول البيانات:
- id - معرف قاعدة البيانات الداخلي
- inner_id - معرف الإعلان على المنصة
- url - رابط الإعلان
- mark - ماركة السيارة
- model - موديل السيارة
- configuration - التكوين
- complectation - مستوى التجهيز
- year - سنة الإنتاج
- color - اللون
- price_eur - السعر باليورو (إجمالي)
- km_age - المسافة المقطوعة بالكيلومتر
- engine_type - نوع المحرك
- transmission_type - نوع ناقل الحركة
- body_type - نوع الهيكل
- address - العنوان
- seller_type - نوع البائع
- is_dealer - علامة الوكيل (true/false)
- seller - البائع
- seller_id - معرف الوكيل
- description - الوصف
- displacement - سعة المحرك (لتر)
- horse_power - القدرة بالحصان
- first_registration - تاريخ التسجيل الأول
- images - مصفوفة روابط الصور
GET/change_id
الحصول على أول معرف تغيير حسب التاريخ (للاستخدام في /changes)
المعاملات:
date(مطلوب) - التاريخ بتنسيق yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/autoscout24/change_id?api_key=YOUR_API_KEY&date=2025-01-15الاستجابة:
{ "change_id": 9182734 }استخدم القيمة المرجعة كمعامل change_id في /changes
GET/changes
تغذية التغييرات (مضاف/معدل/محذوف)
المعاملات:
change_id(مطلوب) - بدءاً من أي معرف تغيير
https://{access_name}.auto-api.com/api/v2/autoscout24/changes?api_key=YOUR_API_KEY&change_id=1الاستجابة:
{
"result": [
{
"id": 456,
"inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
"change_type": "added", // added - new listing
"created_at": "2025-01-15T10:30:00Z",
"data": { ... } // full listing data
},
{
"id": 457,
"inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549f",
"change_type": "changed", // changed - price update
"created_at": "2025-01-15T10:31:00Z",
"data": { "new_price": 3490 }
},
{
"id": 458,
"inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549g",
"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/autoscout24/offer?api_key=YOUR_API_KEY&inner_id=2aa0d910-4b72-4c69-9638-79ac5c58549eالاستجابة: كائن data (مثل /offers، ولكن بدون غلاف result)
سياسة تخزين البيانات
ملفات التصدير مخزنة مع حد أدنى للاحتفاظ 3 أيام وأرشفة احتياطية تلقائية.
جدول الواجهة البرمجية
تصديرات بيانات يومية مع المحتوى الحالي جاهزة للتحميل.
تنسيق ملف CSV
ملفات بيانات السيارات بصيغة CSV تستخدم رمز الأنبوب (|) كفاصل للأعمدة.
تنسيق الرابط:
معاملات الطلب:
access_name- access_name - معرّف النطاق الفرعي المخصص الفريد.date- date - التاريخ المطلوب بتنسيق yyyy-mm-dd (مثل: 2025-09-06).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'AutoScout24 هو سوق السيارات الإلكتروني الرائد في أوروبا، يعمل في 18 دولة منذ عام 1998. مع أكثر من 2 مليون إعلان نشط، إنه مصدر رئيسي لبيانات السيارات الأوروبية. توفر واجهة AutoScout24 البرمجية لدينا وصولاً مباشراً لهذه المعلومات، دون الحاجة إلى محللات أو مستخرجات معقدة.
يتضمن كل إعلان على AutoScout24 المواصفات الفنية وتاريخ الصيانة وتقارير الفحص. تجمع واجهتنا البرمجية هذه البيانات، موفرة معلومات منظمة وجاهزة للاستخدام حول سوق السيارات الأوروبية. أفضل من الجمع اليدوي للبيانات أو استخدام مستخرجات مخصصة.
استخدم واجهة AutoScout24 البرمجية لدينا للوصول لبيانات السوق بما في ذلك فروقات الأسعار الإقليمية والاتجاهات الموسمية وتغيرات توفر المركبات. توفر الواجهة البرمجية مواصفات المركبات وخيارات الشركة المصنعة والتفاصيل المالية لتحليل السوق واتخاذ قرارات أفضل.
تعمل واجهة AutoScout24 البرمجية لدينا في الوقت الفعلي، للعثور على الإعلانات الجديدة خلال 60 ثانية. نتتبع أيضاً متى تباع السيارات لمعرفة الأسعار الفعلية. الوصول لبيانات السوق هذه من خلال واجهتنا البرمجية، دون الحاجة إلى جمع بيانات مخصص.
وسّع تغطية بيانات سياراتك عبر الأسواق العالمية باستخدام واجهاتنا البرمجية للمنصات: