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) |
|---|---|---|---|---|
| 19689 | 19021 | SÉTIF سطيف | BEIDHA BORDJ | بيضاء برج |
| 19690 | 19022 | SÉTIF سطيف | BELLAA | بلاعة |
| 19691 | 19031 | SÉTIF سطيف | BENI CHEBANA | بني شبانة |
| 19692 | 19023 | SÉTIF سطيف | BENI FOUDA | بني فودة |
| 19693 | 19011 | SÉTIF سطيف | BENI OURTILANE | بني ورتيلان |
| 19694 | 19037 | SÉTIF سطيف | BENI OUSSINE | بني وسين |
| 19695 | 19010 | SÉTIF سطيف | BENI-AZIZ | بني عزيز |
| 19696 | 19038 | SÉTIF سطيف | BENI-MOUHLI | بني موحلي |
| 19697 | 19039 | SÉTIF سطيف | BIR HADDADA | بئر حدادة |
| 19698 | 19024 | SÉTIF سطيف | BIR-EL-ARCH | بئر العرش |
| 19699 | 19012 | SÉTIF سطيف | BOUANDAS | بوعنداس |
| 19700 | 19003 | SÉTIF سطيف | BOUGAA | بوقاعة |
| 19701 | 19052 | SÉTIF سطيف | BOUSSELAM | بوسلام |
| 19702 | 19089 | SÉTIF سطيف | BOUTALEB | بوطالب |
| 19703 | 19041 | SÉTIF سطيف | DEHAMCHA | الدهامشة |
| 19704 | 19025 | SÉTIF سطيف | DJEMILA | جميلة |
| 19705 | 19029 | SÉTIF سطيف | DRAA-KEBILA | ذراع قبيلة |
| 19706 | 19001 | SÉTIF سطيف | EL EULMA | العلمة |
| 19707 | 19047 | SÉTIF سطيف | EL OURICIA | أوريسيا |
| 19708 | 19046 | SÉTIF سطيف | EL-OULDJA | الولجة |
BEIDHA BORDJ
بيضاء برج
19689
19021
SÉTIF — سطيف
BELLAA
بلاعة
19690
19022
SÉTIF — سطيف
BENI CHEBANA
بني شبانة
19691
19031
SÉTIF — سطيف
BENI FOUDA
بني فودة
19692
19023
SÉTIF — سطيف
BENI OURTILANE
بني ورتيلان
19693
19011
SÉTIF — سطيف
BENI OUSSINE
بني وسين
19694
19037
SÉTIF — سطيف
BENI-AZIZ
بني عزيز
19695
19010
SÉTIF — سطيف
BENI-MOUHLI
بني موحلي
19696
19038
SÉTIF — سطيف
BIR HADDADA
بئر حدادة
19697
19039
SÉTIF — سطيف
BIR-EL-ARCH
بئر العرش
19698
19024
SÉTIF — سطيف
BOUANDAS
بوعنداس
19699
19012
SÉTIF — سطيف
BOUGAA
بوقاعة
19700
19003
SÉTIF — سطيف
BOUSSELAM
بوسلام
19701
19052
SÉTIF — سطيف
BOUTALEB
بوطالب
19702
19089
SÉTIF — سطيف
DEHAMCHA
الدهامشة
19703
19041
SÉTIF — سطيف
DJEMILA
جميلة
19704
19025
SÉTIF — سطيف
DRAA-KEBILA
ذراع قبيلة
19705
19029
SÉTIF — سطيف
EL EULMA
العلمة
19706
19001
SÉTIF — سطيف
EL OURICIA
أوريسيا
19707
19047
SÉTIF — سطيف
EL-OULDJA
الولجة
19708
19046
SÉTIF — سطيف
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'