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) |
|---|---|---|---|---|
| 311124 | 31017 | ORAN وهران | GDYEL | قديل |
| 311125 | 31049 | ORAN وهران | HASSI BEN OKBA | حاسي بن عقبة |
| 311126 | 31028 | ORAN وهران | HASSI BOUNIF | حاسي بونيف |
| 311127 | 31046 | ORAN وهران | HASSI MEFSOUKH | حاسي مفسوخ |
| 311128 | 31030 | ORAN وهران | MARSAT EL HADJADJ | مرسى الحجاج |
| 311129 | 00000 | ORAN وهران | MERS EL KEBIR | المرسى الكبير |
| 311130 | 00000 | ORAN وهران | MESSERGHIN | مسرغين |
| 311131 | 00000 | ORAN وهران | ORAN | وهران |
| 311132 | 31037 | ORAN وهران | OUED TLELAT | وادي تليلات |
| 311133 | 31058 | ORAN وهران | SIDI BEN YEBKA | سيدي بن يبقى |
| 311134 | 31038 | ORAN وهران | SIDI CHAMI | سيدي الشحمي |
| 311135 | 31077 | ORAN وهران | TAFRAOUI | طفراوي |
| 321138 | 32006 | EL BAYADH البيض | BOUALEM | بوعلام |
| 321139 | 32001 | EL BAYADH البيض | BOUGTOUB | بوقطب |
| 321141 | 32002 | EL BAYADH البيض | BREZINA | بريزينة |
| 321142 | 32022 | EL BAYADH البيض | CHEGUIG | الشقيق |
| 321144 | 32000 | EL BAYADH البيض | EL BAYADH | البيض |
| 321147 | 32011 | EL BAYADH البيض | EL KHEITER | الخيثر |
| 321149 | 32017 | EL BAYADH البيض | GHASSOUL | الغاسول |
| 321150 | 32013 | EL BAYADH البيض | KEF EL AHMAR | الكاف الأحمر |
GDYEL
قديل
311124
31017
ORAN — وهران
HASSI BEN OKBA
حاسي بن عقبة
311125
31049
ORAN — وهران
HASSI BOUNIF
حاسي بونيف
311126
31028
ORAN — وهران
HASSI MEFSOUKH
حاسي مفسوخ
311127
31046
ORAN — وهران
MARSAT EL HADJADJ
مرسى الحجاج
311128
31030
ORAN — وهران
MERS EL KEBIR
المرسى الكبير
311129
00000
ORAN — وهران
MESSERGHIN
مسرغين
311130
00000
ORAN — وهران
ORAN
وهران
311131
00000
ORAN — وهران
OUED TLELAT
وادي تليلات
311132
31037
ORAN — وهران
SIDI BEN YEBKA
سيدي بن يبقى
311133
31058
ORAN — وهران
SIDI CHAMI
سيدي الشحمي
311134
31038
ORAN — وهران
TAFRAOUI
طفراوي
311135
31077
ORAN — وهران
BOUALEM
بوعلام
321138
32006
EL BAYADH — البيض
BOUGTOUB
بوقطب
321139
32001
EL BAYADH — البيض
BREZINA
بريزينة
321141
32002
EL BAYADH — البيض
CHEGUIG
الشقيق
321142
32022
EL BAYADH — البيض
EL BAYADH
البيض
321144
32000
EL BAYADH — البيض
EL KHEITER
الخيثر
321147
32011
EL BAYADH — البيض
GHASSOUL
الغاسول
321149
32017
EL BAYADH — البيض
KEF EL AHMAR
الكاف الأحمر
321150
32013
EL BAYADH — البيض
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'