Wilayas & Communes d'Algérie
Code Géographique National - Juin 2021 — 58 wilayas, 1 541 communes — Voir la carte interactive
| Code ONS | Code Postal | Wilaya | Commune | Commune (Arabe) |
|---|---|---|---|---|
| 27969 | 27003 | MOSTAGANEM مستغانم | BOUGUIRAT | بوقيراط |
| 27970 | 27014 | MOSTAGANEM مستغانم | FORNAKA | فرناقة |
| 27971 | 27015 | MOSTAGANEM مستغانم | HADJADJ | حجاج |
| 27972 | 27004 | MOSTAGANEM مستغانم | HASSI MAMECHE | حاسي ماماش |
| 27973 | 27033 | MOSTAGANEM مستغانم | HASSIANE | الحسيان (بني ياحي |
| 27974 | 27005 | MOSTAGANEM مستغانم | KHADRA | خضرة |
| 27975 | 27016 | MOSTAGANEM مستغانم | KHEIR-EDDINE | خير الدين |
| 27976 | 27036 | MOSTAGANEM مستغانم | MANSOURAH | منصورة |
| 27977 | 27017 | MOSTAGANEM مستغانم | MAZAGRAN | مزغران |
| 27978 | 27018 | MOSTAGANEM مستغانم | MESRA | ماسرة |
| 27979 | 00000 | MOSTAGANEM مستغانم | MOSTAGANEM | مستغانم |
| 27980 | 27026 | MOSTAGANEM مستغانم | NEKMARIA | نكمارية |
| 27981 | 27020 | MOSTAGANEM مستغانم | OUED EL KHEIR | وادي الخير |
| 27982 | 27027 | MOSTAGANEM مستغانم | OULED BOUGHALEM | أولاد بوغالم |
| 27983 | 27028 | MOSTAGANEM مستغانم | OULED-MAALAH | أولاد مع الله |
| 27984 | MOSTAGANEM مستغانم | SAFSAF | صفصاف | |
| 27985 | 27045 | MOSTAGANEM مستغانم | SAYADA | صيادة |
| 27986 | 27032 | MOSTAGANEM مستغانم | SIDI ALI | سيدي علي |
| 27987 | 27029 | MOSTAGANEM مستغانم | SIDI BELAATTAR | سيدي بلعطار |
| 27988 | 27007 | MOSTAGANEM مستغانم | SIDI-LAKHDAR | سيدي لخضر |
BOUGUIRAT
بوقيراط
27969
27003
MOSTAGANEM — مستغانم
FORNAKA
فرناقة
27970
27014
MOSTAGANEM — مستغانم
HADJADJ
حجاج
27971
27015
MOSTAGANEM — مستغانم
HASSI MAMECHE
حاسي ماماش
27972
27004
MOSTAGANEM — مستغانم
HASSIANE
الحسيان (بني ياحي
27973
27033
MOSTAGANEM — مستغانم
KHADRA
خضرة
27974
27005
MOSTAGANEM — مستغانم
KHEIR-EDDINE
خير الدين
27975
27016
MOSTAGANEM — مستغانم
MANSOURAH
منصورة
27976
27036
MOSTAGANEM — مستغانم
MAZAGRAN
مزغران
27977
27017
MOSTAGANEM — مستغانم
MESRA
ماسرة
27978
27018
MOSTAGANEM — مستغانم
MOSTAGANEM
مستغانم
27979
00000
MOSTAGANEM — مستغانم
NEKMARIA
نكمارية
27980
27026
MOSTAGANEM — مستغانم
OUED EL KHEIR
وادي الخير
27981
27020
MOSTAGANEM — مستغانم
OULED BOUGHALEM
أولاد بوغالم
27982
27027
MOSTAGANEM — مستغانم
OULED-MAALAH
أولاد مع الله
27983
27028
MOSTAGANEM — مستغانم
SAFSAF
صفصاف
27984
MOSTAGANEM — مستغانم
SAYADA
صيادة
27985
27045
MOSTAGANEM — مستغانم
SIDI ALI
سيدي علي
27986
27032
MOSTAGANEM — مستغانم
SIDI BELAATTAR
سيدي بلعطار
27987
27029
MOSTAGANEM — مستغانم
SIDI-LAKHDAR
سيدي لخضر
27988
27007
MOSTAGANEM — مستغانم
Documentation API
GET /api/wilayas
GET /api/wilayas/{code}
GET /api/communes
GET
/api/wilayas
Retourne la liste des 58 wilayas d'Algérie. Chaque wilaya contient son code (sur 2 chiffres), son nom en français et son nom en arabe.
Un paramètre de recherche optionnel permet de filtrer par code, nom français ou nom arabe.
Paramètres
| Nom | Type | Description |
|---|---|---|
| q optionnel | string | Recherche sur le code, le nom français ou le nom arabe de la wilaya |
Réponse 200 OK
[ { "code": "16", "name": "ALGER", "name_ar": "الجزائر" }, { "code": "31", "name": "ORAN", "name_ar": "وهران" } // ... ]
PHP
Python
cURL
// Lister toutes les wilayas $response = file_get_contents('https://data.dz-immo.com/api/wilayas'); $wilayas = json_decode($response, true); foreach ($wilayas as $w) { echo $w['code'] . ' - ' . $w['name'] . ' (' . $w['name_ar'] . ")\n"; } // Rechercher une wilaya par nom $q = urlencode('alger'); $results = json_decode( file_get_contents("https://data.dz-immo.com/api/wilayas?q={$q}"), true ); // Avec cURL (gestion d'erreurs) $ch = curl_init('https://data.dz-immo.com/api/wilayas'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Accept: application/json'], ]); $response = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($status === 200) { $wilayas = json_decode($response, true); }
import requests # Lister toutes les wilayas response = requests.get("https://data.dz-immo.com/api/wilayas") wilayas = response.json() for w in wilayas: print(f"{w['code']} - {w['name']} ({w['name_ar']})") # Rechercher une wilaya response = requests.get( "https://data.dz-immo.com/api/wilayas", params={"q": "alger"} ) results = response.json() # Construire un dictionnaire code -> nom wilaya_map = {w["code"]: w["name"] for w in wilayas} print(wilaya_map["16"]) # ALGER
# Toutes les wilayas curl https://data.dz-immo.com/api/wilayas # Rechercher par nom curl "https://data.dz-immo.com/api/wilayas?q=oran" # Rechercher en arabe curl "https://data.dz-immo.com/api/wilayas?q=وهران"
GET
/api/wilayas/{code}
Retourne le détail d'une wilaya identifiée par son code (2 chiffres), accompagnée de la liste complète de ses communes.
Si le code n'existe pas, l'API retourne une erreur 404.
Paramètres d'URL
| Nom | Type | Description |
|---|---|---|
| code | string | Code de la wilaya sur 2 chiffres (ex: 16 pour Alger, 31 pour Oran) |
Réponse 200 OK
{ "code": "16", "name": "ALGER", "name_ar": "الجزائر", "communes": [ { "code": "01", "name": "ALGER CENTRE", "name_ar": "الجزائر الوسطى" }, { "code": "05", "name": "BAB EL OUED", "name_ar": "باب الوادي" } // ... 57 communes au total ] }
Erreur 404
{ "error": "Wilaya not found" }
PHP
Python
cURL
// Récupérer Alger (code 16) avec toutes ses communes $code = '16'; $response = file_get_contents("https://data.dz-immo.com/api/wilayas/{$code}"); $wilaya = json_decode($response, true); echo $wilaya['name'] . " contient " . count($wilaya['communes']) . " communes\n"; // Afficher chaque commune foreach ($wilaya['communes'] as $c) { echo sprintf( " %s-%s %-25s %s\n", $wilaya['code'], $c['code'], $c['name'], $c['name_ar'] ); } // Construire un select HTML $html = '<select name="commune">'; foreach ($wilaya['communes'] as $c) { $html .= "<option value=\"{$c['code']}\">" . "{$c['name']} ({$c['name_ar']})</option>"; } $html .= '</select>';
import requests # Récupérer une wilaya et ses communes code = "16" response = requests.get(f"https://data.dz-immo.com/api/wilayas/{code}") response.raise_for_status() # lève une exception si 404 wilaya = response.json() print(f"{wilaya['name']} : {len(wilaya['communes'])} communes") # Créer un DataFrame pandas import pandas as pd df = pd.DataFrame(wilaya["communes"]) print(df.to_string(index=False)) # Exporter en CSV df.to_csv(f"communes_wilaya_{code}.csv", index=False)
# Détail de la wilaya d'Alger curl https://data.dz-immo.com/api/wilayas/16 # Détail de la wilaya d'Oran curl https://data.dz-immo.com/api/wilayas/31 # Formatter la sortie avec jq curl -s https://data.dz-immo.com/api/wilayas/16 | jq '.communes[] | .name'
GET
/api/communes
Retourne la liste des communes avec des filtres combinables : recherche textuelle et/ou filtrage par code de wilaya.
Sans filtre, retourne les 1 541 communes. Chaque commune inclut les informations de sa wilaya parente.
Paramètres
| Nom | Type | Description |
|---|---|---|
| q optionnel | string | Recherche sur le code, le nom français ou le nom arabe de la commune |
| wilaya optionnel | string | Code de la wilaya pour filtrer les communes (2 chiffres, ex: 16) |
Réponse 200 OK
[ { "wilaya_code": "16", "wilaya_name": "ALGER", "wilaya_name_ar": "الجزائر", "code": "05", "name": "BAB EL OUED", "name_ar": "باب الوادي" } // ... ]
PHP
Python
cURL
// Communes d'une wilaya $wilayaCode = '16'; $response = file_get_contents( "https://data.dz-immo.com/api/communes?wilaya={$wilayaCode}" ); $communes = json_decode($response, true); // Rechercher une commune par nom dans une wilaya $q = urlencode('bab'); $response = file_get_contents( "https://data.dz-immo.com/api/communes?wilaya=16&q={$q}" ); $results = json_decode($response, true); // Rechercher dans toutes les wilayas $response = file_get_contents( "https://data.dz-immo.com/api/communes?q=ain" ); $communes = json_decode($response, true); echo count($communes) . " communes contiennent 'ain'\n"; // Regrouper les communes par wilaya $grouped = []; foreach ($communes as $c) { $grouped[$c['wilaya_name']][] = $c['name']; }
import requests # Communes d'une wilaya response = requests.get( "https://data.dz-immo.com/api/communes", params={"wilaya": "16"} ) communes = response.json() # Rechercher + filtrer par wilaya response = requests.get( "https://data.dz-immo.com/api/communes", params={"q": "bab", "wilaya": "16"} ) # Charger toutes les communes dans un DataFrame import pandas as pd all_communes = requests.get("https://data.dz-immo.com/api/communes").json() df = pd.DataFrame(all_communes) # Nombre de communes par wilaya print(df.groupby("wilaya_name").size().sort_values(ascending=False)) # Exporter tout en CSV df.to_csv("communes_algerie.csv", index=False)
# Toutes les communes curl https://data.dz-immo.com/api/communes # Communes de la wilaya 16 (Alger) curl "https://data.dz-immo.com/api/communes?wilaya=16" # Rechercher "bab" dans Alger curl "https://data.dz-immo.com/api/communes?wilaya=16&q=bab" # Rechercher dans toutes les wilayas + compter curl -s "https://data.dz-immo.com/api/communes?q=ain" | jq 'length'