API وتغذيات للمطوّرين
ArabGuide موقع ثابت بالكامل — لا يوجد مفاتيح API ولا حدود معدّل. كل البيانات متاحة مباشرة عبر طلبات HTTP عادية بدون مصادقة. استخدمها لبناء تطبيقات، تحليلات، أو دمج ArabGuide في موقعك.
ترخيص الاستخدام
البيانات الأساسية لـ ArabGuide مفتوحة للاستخدام غير التجاري بشرط الإسناد. للاستخدام التجاري أو إعادة النشر، تواصل معنا.
المحتويات
البحث والاكتشاف
كل مفهرسات الموقع مدمجة في ملف واحد: 1311 إدراج + 289 خبر + 95 مقالة + 22 فئة + 24 مدينة. مُستخدَم في البحث المباشر وفي صفحة "اكتشف عشوائياً".
عرض عيّنة
[
{ "t": "listing", "s": "3-maples", "n": "طلال برانبو",
"c": "ترجمة", "img": "/wp-content/...", "url": "/directory/listing/3-maples/" },
{ "t": "news", "s": "news__example", "n": "Article title", ... },
...
]
الحقول: t = نوع (listing/news/blog/category/location/page), s = slug, n = name (مع n_en و n_fr للنسخ المترجمة)، c = category، a = address، img = صورة، url = رابط الصفحة.
وصف OpenSearch — يُتيح للمتصفّحات إضافة بحث ArabGuide كمحرك بحث مدمج.
في فايرفوكس: انقر السهم بجانب شريط البحث ← "إضافة ArabGuide".
التغذيات
تغذية RSS 2.0 لآخر مقالات الأخبار. متوافقة مع Feedly, Inoreader, NetNewsWire.
تغذية JSON Feed 1.1 — صيغة أحدث وأنظف من RSS، مدعومة في NetNewsWire و Feedbin.
عرض عيّنة
{
"version": "https://jsonfeed.org/version/1.1",
"title": "ArabGuide — دليل كندا",
"home_page_url": "https://arabguide.com/",
"feed_url": "https://arabguide.com/feed.json",
"items": [
{ "id": "...", "url": "...", "title": "...",
"content_html": "...", "date_published": "..." }
]
}
خرائط الموقع
فهرس خرائط الموقع — يشير إلى ملف خرائط فرعية. للزواحف (Googlebot, Bingbot).
خريطة الموقع البشرية — قائمة بكل الصفحات منظّمة في فئات.
خريطة أخبار Google — مقالات الأخبار التي صدرت خلال آخر 48 ساعة فقط (متطلب Google).
إرشادات الزواحف. كل المسارات مفتوحة للفهرسة باستثناء /saved/, /compare/, /404/.
العمليات
معلومات البناء (الطابع الزمني، إصدار Node، الموقع) — للتحقّق من النشر الحيّ.
عرض عيّنة
{
"builtAt": "2026-05-03T17:25:00.584Z",
"nodeVersion": "v24.11.0",
"site": "https://arabguide.com",
"name": "ArabGuide"
}
جهة اتصال للإفصاح المسؤول عن الثغرات (RFC 9116). راسل security@arabguide.com.
تصدير الدليل
تصدير كامل للدليل التجاري بصيغة JSON. يضم اسم العمل، الفئة، العنوان، الهاتف، الموقع، البريد، الصورة، تاريخ التحديث.
عرض عيّنة
[
{
"name": "...", "category": "...", "phone": "...",
"email": "...", "website": "...", "address": "...",
"image": "...", "url": "...", "dateModified": "..."
},
...
]
نقطة البداية لمن يريد بناء تطبيق أو موقع بديل من بيانات ArabGuide.
الدليل التجاري بصيغة CSV — قابل للفتح في Excel أو Google Sheets مباشرة.
بيانات لكل إدراج
/directory/listing/{slug}/contact.vcf text/vcard; charset=utf-8 بطاقة vCard 3.0 لكل عمل — حمّلها لإضافة العمل لجهات اتصال هاتفك.
عرض عيّنة
BEGIN:VCARD
VERSION:3.0
FN:Business Name
TEL;TYPE=WORK,VOICE:+1 555 555 5555
ADR;TYPE=WORK:;;Street;City;ON;K1A 0A6;Canada
ORG:Restaurant
URL:https://...
END:VCARD
مثال: /directory/listing/3-maples/contact.vcf
تطبيق ويب تقدّمي (PWA)
بيان تطبيق الويب التقدّمي. يوفّر ميتاداتا للتثبيت على شاشة الجوال + 4 اختصارات سريعة.
عامل الخدمة — تخزين مؤقت ذكي للموارد الثابتة + استراتيجية stale-while-revalidate لـ HTML.
أمثلة استخدام
1. جلب كل الأعمال في فئة معيّنة (JavaScript)
fetch('https://arabguide.com/directory/export.json')
.then(r => r.json())
.then(all => {
const restaurants = all.filter(l => l.category === 'مطعم');
console.log(restaurants.length, 'مطعم');
});
2. الاشتراك بـ RSS من curl
curl -A "MyApp/1.0" https://arabguide.com/rss.xml | xmllint --format -
3. تنزيل بطاقة vCard من سطر الأوامر
curl -O https://arabguide.com/directory/listing/3-maples/contact.vcf
ثم افتح ملف contact.vcf الذي نزّلته في تطبيق جهات الاتصال للاستيراد.
طلب نقطة نهاية جديدة
هل تحتاج بياناتاً بصيغة معيّنة غير المذكورة أعلاه؟ أرسل طلبك — سنفكّر بإضافتها.
