API Algérie - Administrative Divisions

✅ Status: FONCTIONNELLE

L'API Algérie fournit les divisions administratives de l'Algérie (wilayas, daïras, communes) avec support des 11 nouvelles wilayas de 2025.

📊 Structure des données

Nomenclature

Wilaya: Equivalent du département français (58 originales + 11 nouvelles en 2025)
Daïra: Subdivision de la wilaya
Commune: Plus petite subdivision administrative

Codes

wilayaCode: Code wilaya ACTUELLE (2025)
codeWilaya / wilayaCodeHistorique: Code wilaya HISTORIQUE (avant 2025)
code: Code commune INSEE (jamais changé)

📋 Endpoints

1. Liste des wilayas

bash

curl "https://2mnservices.alwaysdata.net/algerie/wilayas"

Réponse :

json

[
  {
    "code": "01",
    "nom": "Adrar",
    "nomAr": "أدرار",
    "chefLieu": "Adrar",
    "wilayaDeleguee": false,
    "nouvelle2025": false,
    "dairasCount": 6,
    "communesCount": 16
  }
]

2. Détails d'une wilaya

bash

curl "https://2mnservices.alwaysdata.net/algerie/wilayas/59"

Réponse :

json

{
  "code": "59",
  "nom": "Aflou",
  "nomAr": "أفلو",
  "chefLieu": "Aflou",
  "wilayaDeleguee": true,
  "nouvelle2025": true,
  "dairasCount": 3,
  "communesCount": 3
}

3. Daïras d'une wilaya

bash

curl "https://2mnservices.alwaysdata.net/algerie/wilayas/59/dairas"

Réponse :

json

[
  {
    "code": "5901",
    "nom": "Aflou",
    "wilayaCode": "59",
    "wilayaCodeHistorique": "03",
    "wilayaNom": "Aflou",
    "communesCount": 1
  }
]

4. Communes d'une wilaya

bash

curl "https://2mnservices.alwaysdata.net/algerie/wilayas/59/communes"

Réponse :

json

[
  {
    "code": "00064",
    "codeWilaya": "03",
    "wilayaCodeHistorique": "03",
    "nom": "Aflou",
    "nomAr": "أفلو",
    "wilayaCode": "59",
    "wilayaNom": "Aflou",
    "dairaCode": "5901",
    "dairaNom": "Aflou",
    "codesPostaux": ["03001", "03020", "03021", "03047", "03050", "03053"]
  }
]

5. Détails d'une daïra

bash

curl "https://2mnservices.alwaysdata.net/algerie/dairas/5901"

Réponse :

json

{
  "code": "5901",
  "nom": "Aflou",
  "wilayaCode": "59",
  "wilayaCodeHistorique": "03",
  "wilayaNom": "Aflou",
  "communesCount": 1
}

6. Communes d'une daïra

bash

curl "https://2mnservices.alwaysdata.net/algerie/dairas/5901/communes"

Réponse :

json

[
  {
    "code": "00064",
    "nom": "Aflou",
    "codesPostaux": ["03001", "03020", "03021", "03047", "03050", "03053"]
  }
]

7. Détails d'une commune

bash

curl "https://2mnservices.alwaysdata.net/algerie/communes/00064"

Réponse :

json

{
  "code": "00064",
  "codeWilaya": "03",
  "wilayaCodeHistorique": "03",
  "nom": "Aflou",
  "nomAr": "أفلو",
  "wilayaCode": "59",
  "wilayaNom": "Aflou",
  "dairaCode": "5901",
  "dairaNom": "Aflou",
  "codesPostaux": ["03001", "03020", "03021", "03047", "03050", "03053"]
}

8. Recherche par nom ou code postal

bash

curl "https://2mnservices.alwaysdata.net/algerie/search?q=Aflou"

Réponse :

json

[
  {
    "code": "00064",
    "nom": "Aflou",
    "wilayaNom": "Aflou"
  }
]

🎯 Exemples concrets

Trouver une commune par nom

bash

# Rechercher "Benian"
curl "https://2mnservices.alwaysdata.net/algerie/search?q=Benian"

Réponse :

json

[
  {
    "code": "00554",
    "nom": "Ain Benian",
    "wilayaCode": "16",
    "wilayaNom": "Alger"
  },
  {
    "code": "01415",
    "nom": "Ain-Benian",
    "wilayaCode": "44",
    "wilayaNom": "Aïn Defla"
  }
]

Trouver une commune par code postal

bash

# Rechercher par code postal 16018
curl "https://2mnservices.alwaysdata.net/algerie/search?q=16018"

Réponse :

json

[
  {
    "code": "00554",
    "nom": "Ain Benian",
    "wilayaCode": "16",
    "wilayaNom": "Alger"
  }
]

Obtenir toutes les infos d'une commune

bash

# Commune Ain Benian (code 00554)
curl "https://2mnservices.alwaysdata.net/algerie/communes/00554"

Réponse :

json

{
  "code": "00554",
  "codeWilaya": "01",
  "wilayaCodeHistorique": "01",
  "nom": "Ain Benian",
  "nomAr": "عين بن يان",
  "wilayaCode": "16",
  "wilayaNom": "Alger",
  "dairaCode": "1608",
  "dairaNom": "Cheraga",
  "codesPostaux": ["16018", "16101", "16120", "16225"]
}

Lister toutes les communes d'une wilaya

bash

# Toutes les communes de la wilaya 59 (Aflou)
curl "https://2mnservices.alwaysdata.net/algerie/wilayas/59/communes"

Lister toutes les communes d'une daïra

bash

# Toutes les communes de la daïra 5901 (Aflou)
curl "https://2mnservices.alwaysdata.net/algerie/dairas/5901/communes"

Filtrer les champs retournés

bash

# Juste le nom, le code postal et la wilaya
curl "https://2mnservices.alwaysdata.net/algerie/search?q=Ain%20Benian&fields=code,nom,wilayaNom,codesPostaux"

Réponse :

json

[
  {
    "code": "00554",
    "nom": "Ain Benian",
    "wilayaNom": "Alger",
    "codesPostaux": ["16018", "16101", "16120", "16225"]
  }
]

🗂️ Les 11 nouvelles wilayas (2025)

Code	Nom	Wilaya historique	Communes
59	Aflou	03 (Laghouat)	3
60	Aïn Oussera	17 (Djelfa)	2
61	Barika	05 (Batna)	3
62	Bir el-Ater	12 (Tébessa)	1
63	Bou Saâda	28 (M'Sila)	3
64	El Abiodh Sidi Cheikh	32 (El Bayadh)	3
65	El Aricha	13 (Tlemcen)	4
66	El Kantara	07 (Biskra)	5
67	Ksar Chellala	14 (Tiaret)	4
68	Ksar El Boukhari	26 (Médéa)	1
69	Messaad	17 (Djelfa)	5

Total : 69 wilayas, 571 daïras, 1541 communes

🔧 Installation et import

bash

# Importer les wilayas
npm run import:algerie:wilayas

# Importer les daïras
npm run import:algerie:dairas

# Importer les communes
npm run import:algerie:communes

# Importer les 11 nouvelles wilayas (2025)
npm run import:algerie:all

# Mettre à jour les daïras pour les nouvelles wilayas
node scripts/recreate-dairas.js

# Exporter vers MongoDB Atlas
node scripts/export-to-atlas.js

📝 Notes

Les codes commune (INSEE) ne changent jamais
wilayaCodeHistorique permet de tracer l'ancienne appartenance
Utile pour les calculs statistiques avant/après 2025
Codes postaux inchangés (reflètent la wilaya historique)

L'API est prête ! 🎉