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) |
|---|---|---|---|---|
| 08263 | 08003 | BÉCHAR بشار | ABADLA | العبادلة |
| 08264 | 08000 | BÉCHAR بشار | BECHAR | بشار |
| 08267 | 08010 | BÉCHAR بشار | BENI-OUNIF | بني ونيف |
| 08268 | 08034 | BÉCHAR بشار | BOUKAIS | بوكايس |
| 08270 | 08023 | BÉCHAR بشار | ERG-FERRADJ | عرق فراج |
| 08272 | 08011 | BÉCHAR بشار | KENADSA | القنادسة |
| 08275 | 08026 | BÉCHAR بشار | LAHMAR | لحمر |
| 08276 | 08027 | BÉCHAR بشار | MACHRAA-HOUARI-BOUMEDIENE | مشرع هواري بومدين |
| 08277 | 08041 | BÉCHAR بشار | MERIDJA | المريجة |
| 08278 | 08042 | BÉCHAR بشار | MOGHEUL | موغل |
| 08280 | 08029 | BÉCHAR بشار | TABELBALA | تبلبالة |
| 08281 | 08030 | BÉCHAR بشار | TAGHIT | تاغيت |
| 09284 | 09023 | BLIDA البليدة | AIN ROMANA | عين الرمانة |
| 09285 | 09003 | BLIDA البليدة | BENI MERED | بني مراد |
| 09286 | 09024 | BLIDA البليدة | BENI-TAMOU | بني تامو |
| 09287 | 09025 | BLIDA البليدة | BENKHELIL | بن خليل |
| 09288 | 09000 | BLIDA البليدة | BLIDA | البليدة |
| 09289 | 09019 | BLIDA البليدة | BOUARFA | بوعرفة |
| 09290 | 09001 | BLIDA البليدة | BOUFARIK | بوفاريك |
| 09291 | 09008 | BLIDA البليدة | BOUGARA | بوقرة |
ABADLA
العبادلة
08263
08003
BÉCHAR — بشار
BECHAR
بشار
08264
08000
BÉCHAR — بشار
BENI-OUNIF
بني ونيف
08267
08010
BÉCHAR — بشار
BOUKAIS
بوكايس
08268
08034
BÉCHAR — بشار
ERG-FERRADJ
عرق فراج
08270
08023
BÉCHAR — بشار
KENADSA
القنادسة
08272
08011
BÉCHAR — بشار
LAHMAR
لحمر
08275
08026
BÉCHAR — بشار
MACHRAA-HOUARI-BOUMEDIENE
مشرع هواري بومدين
08276
08027
BÉCHAR — بشار
MERIDJA
المريجة
08277
08041
BÉCHAR — بشار
MOGHEUL
موغل
08278
08042
BÉCHAR — بشار
TABELBALA
تبلبالة
08280
08029
BÉCHAR — بشار
TAGHIT
تاغيت
08281
08030
BÉCHAR — بشار
AIN ROMANA
عين الرمانة
09284
09023
BLIDA — البليدة
BENI MERED
بني مراد
09285
09003
BLIDA — البليدة
BENI-TAMOU
بني تامو
09286
09024
BLIDA — البليدة
BENKHELIL
بن خليل
09287
09025
BLIDA — البليدة
BLIDA
البليدة
09288
09000
BLIDA — البليدة
BOUARFA
بوعرفة
09289
09019
BLIDA — البليدة
BOUFARIK
بوفاريك
09290
09001
BLIDA — البليدة
BOUGARA
بوقرة
09291
09008
BLIDA — البليدة
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'