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) |
|---|---|---|---|---|
| 16571 | 16032 | ALGER الجزائر | BOUZAREAH | بوزريعة |
| 16572 | 00000 | ALGER الجزائر | CASBAH | القصبة |
| 16573 | 16014 | ALGER الجزائر | CHERAGA | الشراقة |
| 16574 | 00000 | ALGER الجزائر | DAR EL BEIDA | الدار البيضاء |
| 16575 | 16047 | ALGER الجزائر | DELY IBRAHIM | دالي ابراهيم |
| 16576 | 00000 | ALGER الجزائر | DJASR KASENTINA | جسر قسنطينة |
| 16577 | 16049 | ALGER الجزائر | DOUIRA | الدويرة |
| 16578 | 16050 | ALGER الجزائر | DRARIA | الدرارية |
| 16579 | 16104 | ALGER الجزائر | EL ACHOUR | العاشور |
| 16580 | 00000 | ALGER الجزائر | EL BIAR | الابيار |
| 16581 | 00000 | ALGER الجزائر | EL HARRACH | الحراش |
| 16582 | 00000 | ALGER الجزائر | EL MADANIA | المدنية |
| 16583 | 16053 | ALGER الجزائر | EL MAGHARIA | المغارية |
| 16584 | 00000 | ALGER الجزائر | EL MARSA | المرسى |
| 16585 | 16035 | ALGER الجزائر | EL MOURADIA | المرادية |
| 16586 | 16082 | ALGER الجزائر | HAMMAMET | الحمامات |
| 16587 | 16116 | ALGER الجزائر | HERRAOUA | هراوة |
| 16588 | 00000 | ALGER الجزائر | HUSSEIN DEY | حسين داي |
| 16589 | 00000 | ALGER الجزائر | HYDRA | حيدرة |
| 16590 | 16091 | ALGER الجزائر | KHRAISSIA | الخرايسية |
BOUZAREAH
بوزريعة
16571
16032
ALGER — الجزائر
CASBAH
القصبة
16572
00000
ALGER — الجزائر
CHERAGA
الشراقة
16573
16014
ALGER — الجزائر
DAR EL BEIDA
الدار البيضاء
16574
00000
ALGER — الجزائر
DELY IBRAHIM
دالي ابراهيم
16575
16047
ALGER — الجزائر
DJASR KASENTINA
جسر قسنطينة
16576
00000
ALGER — الجزائر
DOUIRA
الدويرة
16577
16049
ALGER — الجزائر
DRARIA
الدرارية
16578
16050
ALGER — الجزائر
EL ACHOUR
العاشور
16579
16104
ALGER — الجزائر
EL BIAR
الابيار
16580
00000
ALGER — الجزائر
EL HARRACH
الحراش
16581
00000
ALGER — الجزائر
EL MADANIA
المدنية
16582
00000
ALGER — الجزائر
EL MAGHARIA
المغارية
16583
16053
ALGER — الجزائر
EL MARSA
المرسى
16584
00000
ALGER — الجزائر
EL MOURADIA
المرادية
16585
16035
ALGER — الجزائر
HAMMAMET
الحمامات
16586
16082
ALGER — الجزائر
HERRAOUA
هراوة
16587
16116
ALGER — الجزائر
HUSSEIN DEY
حسين داي
16588
00000
ALGER — الجزائر
HYDRA
حيدرة
16589
00000
ALGER — الجزائر
KHRAISSIA
الخرايسية
16590
16091
ALGER — الجزائر
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'