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) |
|---|---|---|---|---|
| 15531 | 15017 | TIZI OUZOU تيزي وزو | MAATKAS | معـــاتقة |
| 15532 | 15040 | TIZI OUZOU تيزي وزو | MAKOUDA | ماكودة |
| 15533 | 15041 | TIZI OUZOU تيزي وزو | MECHTRAS | مشطراس |
| 15534 | 15014 | TIZI OUZOU تيزي وزو | MEKLA | مقــلع |
| 15535 | 15061 | TIZI OUZOU تيزي وزو | MIZRANA | ميزرانـــة |
| 15536 | 15046 | TIZI OUZOU تيزي وزو | M'KIRA | مكيرة |
| 15537 | 15015 | TIZI OUZOU تيزي وزو | OUACIF | واسيف |
| 15538 | 15016 | TIZI OUZOU تيزي وزو | OUADHIAS | واضية |
| 15539 | 15045 | TIZI OUZOU تيزي وزو | OUAGUENOUN | واقنون |
| 15540 | 15042 | TIZI OUZOU تيزي وزو | SIDI NAMANE | سيدي نعمان |
| 15541 | 15043 | TIZI OUZOU تيزي وزو | SOUAMA | صوامـــع |
| 15542 | 15123 | TIZI OUZOU تيزي وزو | SOUK-EL-TENINE | سوق الإثنين |
| 15543 | 15018 | TIZI OUZOU تيزي وزو | TADMAIT | تادمايت |
| 15544 | 15019 | TIZI OUZOU تيزي وزو | TIGZIRT | تيقـزيرت |
| 15545 | 15039 | TIZI OUZOU تيزي وزو | TIMIZART | تيمـيزار |
| 15546 | 15048 | TIZI OUZOU تيزي وزو | TIRMITINE | تيرمتين |
| 15547 | 15049 | TIZI OUZOU تيزي وزو | TIZI N'TLETA | تيزي نثلاثة |
| 15548 | 15020 | TIZI OUZOU تيزي وزو | TIZI-GHENIFF | تيزي غنيف |
| 15549 | 15000 | TIZI OUZOU تيزي وزو | TIZI-OUZOU | تيزي وزو |
| 15550 | 15050 | TIZI OUZOU تيزي وزو | TIZI-RACHED | تيزي راشد |
MAATKAS
معـــاتقة
15531
15017
TIZI OUZOU — تيزي وزو
MAKOUDA
ماكودة
15532
15040
TIZI OUZOU — تيزي وزو
MECHTRAS
مشطراس
15533
15041
TIZI OUZOU — تيزي وزو
MEKLA
مقــلع
15534
15014
TIZI OUZOU — تيزي وزو
MIZRANA
ميزرانـــة
15535
15061
TIZI OUZOU — تيزي وزو
M'KIRA
مكيرة
15536
15046
TIZI OUZOU — تيزي وزو
OUACIF
واسيف
15537
15015
TIZI OUZOU — تيزي وزو
OUADHIAS
واضية
15538
15016
TIZI OUZOU — تيزي وزو
OUAGUENOUN
واقنون
15539
15045
TIZI OUZOU — تيزي وزو
SIDI NAMANE
سيدي نعمان
15540
15042
TIZI OUZOU — تيزي وزو
SOUAMA
صوامـــع
15541
15043
TIZI OUZOU — تيزي وزو
SOUK-EL-TENINE
سوق الإثنين
15542
15123
TIZI OUZOU — تيزي وزو
TADMAIT
تادمايت
15543
15018
TIZI OUZOU — تيزي وزو
TIGZIRT
تيقـزيرت
15544
15019
TIZI OUZOU — تيزي وزو
TIMIZART
تيمـيزار
15545
15039
TIZI OUZOU — تيزي وزو
TIRMITINE
تيرمتين
15546
15048
TIZI OUZOU — تيزي وزو
TIZI N'TLETA
تيزي نثلاثة
15547
15049
TIZI OUZOU — تيزي وزو
TIZI-GHENIFF
تيزي غنيف
15548
15020
TIZI OUZOU — تيزي وزو
TIZI-OUZOU
تيزي وزو
15549
15000
TIZI OUZOU — تيزي وزو
TIZI-RACHED
تيزي راشد
15550
15050
TIZI OUZOU — تيزي وزو
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'