API وتغذيات للمطوّرين
ArabGuide موقع ثابت بالكامل — لا يوجد مفاتيح API ولا حدود معدّل. كل البيانات متاحة مباشرة عبر طلبات HTTP عادية بدون مصادقة. استخدمها لبناء تطبيقات، تحليلات، أو دمج ArabGuide في موقعك.
ترخيص الاستخدام
البيانات الأساسية لـ ArabGuide مفتوحة للاستخدام غير التجاري بشرط الإسناد. للاستخدام التجاري أو إعادة النشر، تواصل معنا.
المحتويات
Search & Discovery
كل مفهرسات الموقع مدمجة في ملف واحد: 1447 إدراج + 289 خبر + 95 مقالة + 22 فئة + 22 مدينة. مُستخدَم في البحث المباشر وفي صفحة "اكتشف عشوائياً".
عرض عيّنة
[
{ "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), s = slug, n = name, c = category, a = address, img = صورة, url = رابط الصفحة.
وصف OpenSearch — يُتيح للمتصفّحات إضافة بحث ArabGuide كمحرك بحث مدمج.
في فايرفوكس: انقر السهم بجانب شريط البحث ← "إضافة ArabGuide".
Feeds
تغذية 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": "..." }
]
}
Sitemaps
فهرس خرائط الموقع — يشير إلى ملف خرائط فرعية. للزواحف (Googlebot, Bingbot).
خريطة الموقع البشرية — قائمة بكل الصفحات منظّمة في فئات.
خريطة أخبار Google — مقالات الأخبار التي صدرت خلال آخر 48 ساعة فقط (متطلب Google).
إرشادات الزواحف. كل المسارات مفتوحة للفهرسة باستثناء /saved/, /compare/, /404/.
Operations
معلومات البناء (الطابع الزمني، إصدار Node، الموقع) — للتحقّق من النشر الحيّ.
عرض عيّنة
{
"builtAt": "2026-05-03T17:25:00.584Z",
"nodeVersion": "v24.11.0",
"site": "https://arabguide.com",
"name": "ArabGuide"
}
جهة اتصال للإفصاح المسؤول عن الثغرات (RFC 9116). راسل security@arabguide.com.
Directory Exports
تصدير كامل للدليل التجاري بصيغة JSON. يضم اسم العمل، الفئة، العنوان، الهاتف، الموقع، البريد، الصورة، تاريخ التحديث.
عرض عيّنة
[
{
"name": "...", "category": "...", "phone": "...",
"email": "...", "website": "...", "address": "...",
"image": "...", "url": "...", "dateModified": "..."
},
...
]
نقطة البداية لمن يريد بناء تطبيق أو موقع بديل من بيانات ArabGuide.
الدليل التجاري بصيغة CSV — قابل للفتح في Excel أو Google Sheets مباشرة.
Per-Listing Data
بطاقة 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
# ثم استورد الملف في تطبيق جهات الاتصال
طلب نقطة نهاية جديدة
هل تحتاج بياناتاً بصيغة معيّنة غير المذكورة أعلاه؟ أرسل طلبك — سنفكّر بإضافتها.
