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) |
|---|---|---|---|---|
| 67471 | 14026 | KSAR CHELLALA قصر الشلالة | RECHAIGA | الرشايقة |
| 67474 | 14051 | KSAR CHELLALA قصر الشلالة | SERGHINE | سرغين |
| 67486 | 14038 | KSAR CHELLALA قصر الشلالة | ZMALET EL EMIR ABDELKADE | زمالة الأمير عبد القادر |
| 68613 | 17040 | AIN OUSSERA عين وسارة | AIN FEKKA | عين فقه |
| 68615 | 17001 | AIN OUSSERA عين وسارة | AIN OUSSERA | عين وسارة |
| 68617 | 17043 | AIN OUSSERA عين وسارة | BENHAR | بنهار |
| 68619 | 17014 | AIN OUSSERA عين وسارة | BIRINE | بيرين |
| 68620 | 17044 | AIN OUSSERA عين وسارة | BOUIRA LAHDAB | بويرة الأحداب |
| 68628 | 17051 | AIN OUSSERA عين وسارة | EL KHEMIS | الخميس |
| 68630 | 17054 | AIN OUSSERA عين وسارة | GUERNINI | قرنيني |
| 68632 | 17022 | AIN OUSSERA عين وسارة | HAD SAHARY | حد الصحاري |
| 68635 | 17056 | AIN OUSSERA عين وسارة | HASSI FEDOUL | حاسي فدول |
| 68643 | 17024 | AIN OUSSERA عين وسارة | SIDI LAADJEL | سيدي لعجال |
| 69616 | 17042 | MESSAAD مسعد | AMOURAH | عمورة |
| 69623 | 17046 | MESSAAD مسعد | DELDOUL | دلدول |
| 69629 | 17021 | MESSAAD مسعد | FAIDH EL BOTMA | فيض البطمة |
| 69631 | 17055 | MESSAAD مسعد | GUETTARA | قطارة |
| 69636 | 17003 | MESSAAD مسعد | MESSAAD | مسعد |
| 69639 | 17061 | MESSAAD مسعد | OUM LAADHAM | أم العظام |
| 69640 | 17062 | MESSAAD مسعد | SED RAHAL | سد الرحال |
RECHAIGA
الرشايقة
67471
14026
KSAR CHELLALA — قصر الشلالة
SERGHINE
سرغين
67474
14051
KSAR CHELLALA — قصر الشلالة
ZMALET EL EMIR ABDELKADE
زمالة الأمير عبد القادر
67486
14038
KSAR CHELLALA — قصر الشلالة
AIN FEKKA
عين فقه
68613
17040
AIN OUSSERA — عين وسارة
AIN OUSSERA
عين وسارة
68615
17001
AIN OUSSERA — عين وسارة
BENHAR
بنهار
68617
17043
AIN OUSSERA — عين وسارة
BIRINE
بيرين
68619
17014
AIN OUSSERA — عين وسارة
BOUIRA LAHDAB
بويرة الأحداب
68620
17044
AIN OUSSERA — عين وسارة
EL KHEMIS
الخميس
68628
17051
AIN OUSSERA — عين وسارة
GUERNINI
قرنيني
68630
17054
AIN OUSSERA — عين وسارة
HAD SAHARY
حد الصحاري
68632
17022
AIN OUSSERA — عين وسارة
HASSI FEDOUL
حاسي فدول
68635
17056
AIN OUSSERA — عين وسارة
SIDI LAADJEL
سيدي لعجال
68643
17024
AIN OUSSERA — عين وسارة
AMOURAH
عمورة
69616
17042
MESSAAD — مسعد
DELDOUL
دلدول
69623
17046
MESSAAD — مسعد
FAIDH EL BOTMA
فيض البطمة
69629
17021
MESSAAD — مسعد
GUETTARA
قطارة
69631
17055
MESSAAD — مسعد
MESSAAD
مسعد
69636
17003
MESSAAD — مسعد
OUM LAADHAM
أم العظام
69639
17061
MESSAAD — مسعد
SED RAHAL
سد الرحال
69640
17062
MESSAAD — مسعد
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'