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) |
|---|---|---|---|---|
| 62236 | 07023 | EL KANTARA القنطرة | BRANIS | برانيس |
| 62239 | 07025 | EL KANTARA القنطرة | DJEMORAH | جمورة |
| 62245 | 07008 | EL KANTARA القنطرة | EL KANTARA | القنطرة |
| 62246 | 07030 | EL KANTARA القنطرة | EL OUTAYA | الوطاية |
| 63122 | 05001 | BARIKA بريكة | BARIKA | بريكة |
| 63125 | 05045 | BARIKA بريكة | BITAM | بيطام |
| 63133 | 05046 | BARIKA بريكة | DJEZZAR | الجزار |
| 63149 | 05037 | BARIKA بريكة | M DOUKAL | إمدوكل |
| 63157 | 05121 | BARIKA بريكة | OULED AMMAR | أولاد عمار |
| 63166 | 05027 | BARIKA بريكة | SEGGANA | سقانة |
| 63175 | 05127 | BARIKA بريكة | TILATOU | تيلاطو |
| 641001 | 28009 | BOU SAADA بوسعادة | BEN SROUR | بن سرور |
| 641003 | 28028 | BOU SAADA بوسعادة | BENZOUH | بن زوه |
| 641005 | 28043 | BOU SAADA بوسعادة | BIR FODA | بئر فضة |
| 641006 | 28001 | BOU SAADA بوسعادة | BOU SAADA | بوسعادة |
| 641010 | 28024 | BOU SAADA بوسعادة | DJEBEL MESSAAD | جبل مساعد |
| 641011 | 28015 | BOU SAADA بوسعادة | EL HAMEL | الهامل |
| 641012 | BOU SAADA بوسعادة | EL HOUAMED | الحوامد | |
| 641015 | 28030 | BOU SAADA بوسعادة | KHOUBANA | خبانة |
| 641020 | 28016 | BOU SAADA بوسعادة | MEDJEDEL | امجدل |
BRANIS
برانيس
62236
07023
EL KANTARA — القنطرة
DJEMORAH
جمورة
62239
07025
EL KANTARA — القنطرة
EL KANTARA
القنطرة
62245
07008
EL KANTARA — القنطرة
EL OUTAYA
الوطاية
62246
07030
EL KANTARA — القنطرة
BARIKA
بريكة
63122
05001
BARIKA — بريكة
BITAM
بيطام
63125
05045
BARIKA — بريكة
DJEZZAR
الجزار
63133
05046
BARIKA — بريكة
M DOUKAL
إمدوكل
63149
05037
BARIKA — بريكة
OULED AMMAR
أولاد عمار
63157
05121
BARIKA — بريكة
SEGGANA
سقانة
63166
05027
BARIKA — بريكة
TILATOU
تيلاطو
63175
05127
BARIKA — بريكة
BEN SROUR
بن سرور
641001
28009
BOU SAADA — بوسعادة
BENZOUH
بن زوه
641003
28028
BOU SAADA — بوسعادة
BIR FODA
بئر فضة
641005
28043
BOU SAADA — بوسعادة
BOU SAADA
بوسعادة
641006
28001
BOU SAADA — بوسعادة
DJEBEL MESSAAD
جبل مساعد
641010
28024
BOU SAADA — بوسعادة
EL HAMEL
الهامل
641011
28015
BOU SAADA — بوسعادة
EL HOUAMED
الحوامد
641012
BOU SAADA — بوسعادة
KHOUBANA
خبانة
641015
28030
BOU SAADA — بوسعادة
MEDJEDEL
امجدل
641020
28016
BOU SAADA — بوسعادة
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'