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) |
|---|---|---|---|---|
| 25889 | 25037 | CONSTANTINE قسنطينة | BEN BADIS | أبن باديس الهرية |
| 25890 | 25035 | CONSTANTINE قسنطينة | BENI HAMIDANE | بني حميدان |
| 25891 | 00000 | CONSTANTINE قسنطينة | CONSTANTINE | قسنطينة |
| 25892 | 25024 | CONSTANTINE قسنطينة | DIDOUCHE MOURAD | ديدوش مراد |
| 25893 | 25005 | CONSTANTINE قسنطينة | EL KHROUB | الخروب |
| 25894 | 25013 | CONSTANTINE قسنطينة | HAMMA BOUZIANE | حامة بوزيان |
| 25895 | 25027 | CONSTANTINE قسنطينة | IBN ZIAD | ابن زياد |
| 25896 | 25032 | CONSTANTINE قسنطينة | MESSAOUD BOUDJERIOU | بوجريو مسعود |
| 25897 | 25028 | CONSTANTINE قسنطينة | OULED RAHMOUN | أولاد رحمون |
| 25898 | 00000 | CONSTANTINE قسنطينة | ZIGHOUD YOUCEF | زيغود يوسف |
| 26901 | 26022 | MÉDÉA المدية | AISSAOUIA | العيساوية |
| 26903 | 26050 | MÉDÉA المدية | BAATA | بعطة |
| 26904 | 26012 | MÉDÉA المدية | BEN CHICAO | بن شكاو |
| 26905 | 26001 | MÉDÉA المدية | BENI SLIMANE | بني سليمان |
| 26906 | 00000 | MÉDÉA المدية | BERROUAGHIA | البرواقية |
| 26907 | 26053 | MÉDÉA المدية | BIR BEN LAABED | بئر بن عابد |
| 26910 | 26055 | MÉDÉA المدية | BOUAICHOUNE | بوعيشون |
| 26911 | 26014 | MÉDÉA المدية | BOUCHRAHIL | بوشراحيل |
| 26913 | 26025 | MÉDÉA المدية | BOUSKENE | بوسكن |
| 26918 | 26016 | MÉDÉA المدية | DJOUAB | جواب |
BEN BADIS
أبن باديس الهرية
25889
25037
CONSTANTINE — قسنطينة
BENI HAMIDANE
بني حميدان
25890
25035
CONSTANTINE — قسنطينة
CONSTANTINE
قسنطينة
25891
00000
CONSTANTINE — قسنطينة
DIDOUCHE MOURAD
ديدوش مراد
25892
25024
CONSTANTINE — قسنطينة
EL KHROUB
الخروب
25893
25005
CONSTANTINE — قسنطينة
HAMMA BOUZIANE
حامة بوزيان
25894
25013
CONSTANTINE — قسنطينة
IBN ZIAD
ابن زياد
25895
25027
CONSTANTINE — قسنطينة
MESSAOUD BOUDJERIOU
بوجريو مسعود
25896
25032
CONSTANTINE — قسنطينة
OULED RAHMOUN
أولاد رحمون
25897
25028
CONSTANTINE — قسنطينة
ZIGHOUD YOUCEF
زيغود يوسف
25898
00000
CONSTANTINE — قسنطينة
AISSAOUIA
العيساوية
26901
26022
MÉDÉA — المدية
BAATA
بعطة
26903
26050
MÉDÉA — المدية
BEN CHICAO
بن شكاو
26904
26012
MÉDÉA — المدية
BENI SLIMANE
بني سليمان
26905
26001
MÉDÉA — المدية
BERROUAGHIA
البرواقية
26906
00000
MÉDÉA — المدية
BIR BEN LAABED
بئر بن عابد
26907
26053
MÉDÉA — المدية
BOUAICHOUNE
بوعيشون
26910
26055
MÉDÉA — المدية
BOUCHRAHIL
بوشراحيل
26911
26014
MÉDÉA — المدية
BOUSKENE
بوسكن
26913
26025
MÉDÉA — المدية
DJOUAB
جواب
26918
26016
MÉDÉA — المدية
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'