واجهة برمجة البلديات التونسية

احصل على بيانات شاملة للبلديات التونسية مع خيارات فلترة قوية. مصممة للمطورين، من قبل المطورين.

الرابط الأساسي

GEThttps://tn-municipality-api.vercel.app/api/municipalities

مجانية ومفتوحة المصدر. لا حاجة لمفتاح API.

GET/api/municipalities?postalCode=2058

200

[
  {
    "Name": "ARIANA",
    "NameAr": "أريانة",
    "Value": "ARIANA",
    "Delegations": [
      {
        "Name": "ARIANA VILLE (Residence Kortoba)",
        "NameAr": "أريانة المدينة (إقامة قرطبة)",
        "Value": "ARIANA VILLE",
        "PostalCode": "2058",
        "Latitude": 36.866011,
        "Longitude": 10.193923
      },

فلترة قوية
فلترة حسب الولاية، المعتمدية، الرمز البريدي، والمزيد
بيانات غنية
بيانات كاملة عن البلديات مع الإحداثيات والأسماء العربية
سريع وموثوق
استجابات سريعة للغاية مع ضمان وقت تشغيل بنسبة 99.9٪

كيف تُنظَّم البيانات

ثلاثة مستويات، من الولاية إلى المنطقة، ولكل منها اسم بالعربية والإنجليزية.

الولايات: 24
المعتمديات: 261
المناطق: 4,790
الرموز البريدية: 958

GET/api/municipalities?name=ariana

ARIANAأريانة

ولاية

ARIANA VILLEأريانة المدينة
معتمدية
- Residence Kortobaإقامة قرطبة
  2058منطقة
- Cite El Intissar 1حي الإنتصار 1
  2091
- 33 مناطق أخرى
SIDI THABETسيدي ثابت
5 معتمديات أخرى

ساحة تجريب الواجهة

اختبر الواجهة بالبيانات الحقيقية.

استجابة الواجهة

أرسل طلبًا لعرض استجابة JSON هنا.

استخدمها مع مساعد الذكاء الاصطناعي

انسخ موجّهًا يشرح نقاط النهاية والمعاملات وشكل الاستجابة، ثم الصقه في ChatGPT أو Claude أو Cursor أو Copilot.

llms.txt

نموذج عنوانالبحث بالرمز البريديالمناطق القريبةشيء آخر

افتح في ChatGPT افتح في Claude

llms.txt

توثيق واجهة البرمجة

نقاط النهاية

GET/api/municipalities

عرض البلديات والبحث فيها

GET/api/municipalities/near

البحث عن البلديات القريبة من نقطة

الرابط الأساسيhttps://tn-municipality-api.vercel.app

معاملات الاستعلام

استخدم هذه المعاملات لفلترة بيانات البلديات. جميع المعاملات اختيارية ويمكن دمجها.

المعاملالنوعالوصف

searchstring
يبحث في الولايات أولاً، ثم في المعتمديات إذا لم توجد نتائج. يقبل الأسماء بالعربية أو الإنجليزية.
/api/municipalities?search=ariana
namestring
فلترة حسب اسم الولاية (مثال: أريانة، تونس، صفاقس)
/api/municipalities?name=ariana
delegationstring
فلترة حسب اسم المعتمدية داخل الولاية
/api/municipalities?delegation=ville
postalCodestring
فلترة حسب الرمز البريدي المطابق (4 أرقام)
/api/municipalities?postalCode=2058
sortname | nameAr
ترتيب الولايات حسب name أو nameAr
/api/municipalities?sort=nameAr
orderasc | desc
اتجاه الترتيب: asc (افتراضي) أو desc. يُستخدم مع sort.
/api/municipalities?sort=name&order=desc
lat, lng, radiusnumber
احصل على البلديات القريبة من موقع محدد ضمن نصف قطر (بالكيلومتر)
/api/municipalities/near?lat=36.8065&lng=10.1815&radius=5

أمثلة

curl "https://tn-municipality-api.vercel.app/api/municipalities?name=ariana"

مثال على الاستجابة

200 application/json

[
  {
    "Name": "ARIANA",
    "NameAr": "أريانة",
    "Value": "ARIANA",
    "Delegations": [
      {
        "Name": "ARIANA VILLE (Residence Kortoba)",
        "NameAr": "أريانة المدينة (إقامة قرطبة)",
        "Value": "ARIANA VILLE",
        "PostalCode": "2058",
        "Latitude": 36.866011,
        "Longitude": 10.193923
      }
    ]
  }
]