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) |
|---|---|---|---|---|
| 391297 | 39035 | EL OUED الوادي | OURMES | ورماس |
| 391298 | 39016 | EL OUED الوادي | REGUIBA | الرقيبة |
| 391299 | 39017 | EL OUED الوادي | ROBBAH | الرباح |
| 391301 | 39037 | EL OUED الوادي | SIDI AOUN | سيدي عون |
| 391304 | 39083 | EL OUED الوادي | TAGHZOUT | تغزوت |
| 391305 | 39019 | EL OUED الوادي | TALEB LARBI | الطالب العربي |
| 391307 | 39044 | EL OUED الوادي | TRIFAOUI | الطريفاوي |
| 401308 | 40028 | KHENCHELA خنشلة | AIN TOUILA | عين الطويلة |
| 401309 | 40006 | KHENCHELA خنشلة | BABAR | بابار |
| 401310 | 40014 | KHENCHELA خنشلة | BAGHAI | بغاي |
| 401311 | 40007 | KHENCHELA خنشلة | BOUHMAMA | بوحمامة |
| 401312 | 40008 | KHENCHELA خنشلة | CHECHAR | ششار |
| 401313 | 40030 | KHENCHELA خنشلة | CHELIA | شلية |
| 401314 | 40015 | KHENCHELA خنشلة | DJELLAL | جلال |
| 401315 | 40031 | KHENCHELA خنشلة | EL HAMMA | الحامة |
| 401316 | 40012 | KHENCHELA خنشلة | EL MAHMAL | المحمل |
| 401317 | KHENCHELA خنشلة | EL OUELDJA | الولجة | |
| 401318 | 00000 | KHENCHELA خنشلة | ENSIGHA | انسيغة |
| 401319 | 40001 | KHENCHELA خنشلة | KAIS | قايس |
| 401320 | 00000 | KHENCHELA خنشلة | KHENCHELA | خنشلة |
OURMES
ورماس
391297
39035
EL OUED — الوادي
REGUIBA
الرقيبة
391298
39016
EL OUED — الوادي
ROBBAH
الرباح
391299
39017
EL OUED — الوادي
SIDI AOUN
سيدي عون
391301
39037
EL OUED — الوادي
TAGHZOUT
تغزوت
391304
39083
EL OUED — الوادي
TALEB LARBI
الطالب العربي
391305
39019
EL OUED — الوادي
TRIFAOUI
الطريفاوي
391307
39044
EL OUED — الوادي
AIN TOUILA
عين الطويلة
401308
40028
KHENCHELA — خنشلة
BABAR
بابار
401309
40006
KHENCHELA — خنشلة
BAGHAI
بغاي
401310
40014
KHENCHELA — خنشلة
BOUHMAMA
بوحمامة
401311
40007
KHENCHELA — خنشلة
CHECHAR
ششار
401312
40008
KHENCHELA — خنشلة
CHELIA
شلية
401313
40030
KHENCHELA — خنشلة
DJELLAL
جلال
401314
40015
KHENCHELA — خنشلة
EL HAMMA
الحامة
401315
40031
KHENCHELA — خنشلة
EL MAHMAL
المحمل
401316
40012
KHENCHELA — خنشلة
EL OUELDJA
الولجة
401317
KHENCHELA — خنشلة
ENSIGHA
انسيغة
401318
00000
KHENCHELA — خنشلة
KAIS
قايس
401319
40001
KHENCHELA — خنشلة
KHENCHELA
خنشلة
401320
00000
KHENCHELA — خنشلة
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'