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) |
|---|---|---|---|---|
| 24869 | 24019 | GUELMA قالمة | EL FEDJOUDJ | الفجوج |
| 24870 | 24020 | GUELMA قالمة | GUELAAT BOU SBAA | قلعة بوصبع |
| 24871 | 24000 | GUELMA قالمة | GUELMA | قالمة |
| 24872 | 24007 | GUELMA قالمة | HAMMAM DEBAGH | حمام دباغ |
| 24873 | 24024 | GUELMA قالمة | HAMMAM N'BAIL | حمام النبايل |
| 24874 | 24008 | GUELMA قالمة | HELIOPOLIS | هيليوبوليس |
| 24875 | 24027 | GUELMA قالمة | NECHMAYA | نشماية |
| 24876 | GUELMA قالمة | KHEZARAS | لخزارة | |
| 24877 | 24043 | GUELMA قالمة | MEDJEZ AMAR | مجاز عمار |
| 24878 | 24026 | GUELMA قالمة | MEDJEZ SFA | مجاز الصفاء |
| 24879 | 24025 | GUELMA قالمة | HOUARI BOUMEDIENNE | هواري بومدين |
| 24880 | 24009 | GUELMA قالمة | OUED CHEHAM | وادي الشحم |
| 24881 | 24038 | GUELMA قالمة | OUED FERRAGHA | وادي فراغة |
| 24882 | 24001 | GUELMA قالمة | OUED ZENATI | وادي الزناتي |
| 24883 | 24049 | GUELMA قالمة | RAS EL AGBA | رأس العقبة |
| 24884 | 24028 | GUELMA قالمة | ROKNIA | الركنية |
| 24885 | 24029 | GUELMA قالمة | SELLAOUA ANNOUNA | سلاوة عنونة |
| 24886 | 24010 | GUELMA قالمة | TAMLOUKA | تاملوكة |
| 25887 | 25015 | CONSTANTINE قسنطينة | AIN ABID | عين عبيد |
| 25888 | 25006 | CONSTANTINE قسنطينة | AIN SMARA | عين السمارة |
EL FEDJOUDJ
الفجوج
24869
24019
GUELMA — قالمة
GUELAAT BOU SBAA
قلعة بوصبع
24870
24020
GUELMA — قالمة
GUELMA
قالمة
24871
24000
GUELMA — قالمة
HAMMAM DEBAGH
حمام دباغ
24872
24007
GUELMA — قالمة
HAMMAM N'BAIL
حمام النبايل
24873
24024
GUELMA — قالمة
HELIOPOLIS
هيليوبوليس
24874
24008
GUELMA — قالمة
NECHMAYA
نشماية
24875
24027
GUELMA — قالمة
KHEZARAS
لخزارة
24876
GUELMA — قالمة
MEDJEZ AMAR
مجاز عمار
24877
24043
GUELMA — قالمة
MEDJEZ SFA
مجاز الصفاء
24878
24026
GUELMA — قالمة
HOUARI BOUMEDIENNE
هواري بومدين
24879
24025
GUELMA — قالمة
OUED CHEHAM
وادي الشحم
24880
24009
GUELMA — قالمة
OUED FERRAGHA
وادي فراغة
24881
24038
GUELMA — قالمة
OUED ZENATI
وادي الزناتي
24882
24001
GUELMA — قالمة
RAS EL AGBA
رأس العقبة
24883
24049
GUELMA — قالمة
ROKNIA
الركنية
24884
24028
GUELMA — قالمة
SELLAOUA ANNOUNA
سلاوة عنونة
24885
24029
GUELMA — قالمة
TAMLOUKA
تاملوكة
24886
24010
GUELMA — قالمة
AIN ABID
عين عبيد
25887
25015
CONSTANTINE — قسنطينة
AIN SMARA
عين السمارة
25888
25006
CONSTANTINE — قسنطينة
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'