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) |
|---|---|---|---|---|
| 0233 | 02017 | CHLEF الشلف | BENI HAOUA | بني حواء |
| 0234 | 02035 | CHLEF الشلف | BENI RACHED | بني راشد |
| 0235 | 02002 | CHLEF الشلف | BOUKADIR | بوقادير |
| 0236 | 02019 | CHLEF الشلف | BOUZEGHAIA | بوزغاية |
| 0237 | 02070 | CHLEF الشلف | BREIRA | بريرة |
| 0238 | 02007 | CHLEF الشلف | CHETTIA | الشطية |
| 0239 | 00000 | CHLEF الشلف | CHLEF | الشلف |
| 0240 | 02032 | CHLEF الشلف | DAHRA | الظهرة |
| 0241 | 02050 | CHLEF الشلف | EL HADJADJ | الحجاج |
| 0242 | 02008 | CHLEF الشلف | EL KARIMIA | الكريمية |
| 0243 | 02015 | CHLEF الشلف | EL MARSA | المرسى |
| 0244 | 02031 | CHLEF الشلف | HARCHOUN | حرشون |
| 0245 | 02038 | CHLEF الشلف | HERENFA | الهرانفة |
| 0246 | 02073 | CHLEF الشلف | LABIOD MEDJADJA | الأبيض مجاجة |
| 0247 | 02060 | CHLEF الشلف | MOUSSADEK | مصدق |
| 0248 | 02001 | CHLEF الشلف | OUED FODDA | وادي الفضة |
| 0249 | 02061 | CHLEF الشلف | OUED GOUSSINE | وادي قوسين |
| 0250 | 02011 | CHLEF الشلف | OUED SLY | وادي سلي |
| 0251 | 02029 | CHLEF الشلف | OULED ABBES | أولاد عباس |
| 0252 | 02037 | CHLEF الشلف | OULED BEN ABDELKADER | أولاد بن عبد القادر |
BENI HAOUA
بني حواء
0233
02017
CHLEF — الشلف
BENI RACHED
بني راشد
0234
02035
CHLEF — الشلف
BOUKADIR
بوقادير
0235
02002
CHLEF — الشلف
BOUZEGHAIA
بوزغاية
0236
02019
CHLEF — الشلف
BREIRA
بريرة
0237
02070
CHLEF — الشلف
CHETTIA
الشطية
0238
02007
CHLEF — الشلف
CHLEF
الشلف
0239
00000
CHLEF — الشلف
DAHRA
الظهرة
0240
02032
CHLEF — الشلف
EL HADJADJ
الحجاج
0241
02050
CHLEF — الشلف
EL KARIMIA
الكريمية
0242
02008
CHLEF — الشلف
EL MARSA
المرسى
0243
02015
CHLEF — الشلف
HARCHOUN
حرشون
0244
02031
CHLEF — الشلف
HERENFA
الهرانفة
0245
02038
CHLEF — الشلف
LABIOD MEDJADJA
الأبيض مجاجة
0246
02073
CHLEF — الشلف
MOUSSADEK
مصدق
0247
02060
CHLEF — الشلف
OUED FODDA
وادي الفضة
0248
02001
CHLEF — الشلف
OUED GOUSSINE
وادي قوسين
0249
02061
CHLEF — الشلف
OUED SLY
وادي سلي
0250
02011
CHLEF — الشلف
OULED ABBES
أولاد عباس
0251
02029
CHLEF — الشلف
OULED BEN ABDELKADER
أولاد بن عبد القادر
0252
02037
CHLEF — الشلف
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'