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) |
|---|---|---|---|---|
| 10332 | 10060 | BOUIRA البويرة | EL-MOKRANI | المقراني |
| 10333 | 10037 | BOUIRA البويرة | GUERROUMA | قرومة |
| 10334 | 10065 | BOUIRA البويرة | HADJERA ZERGA | الحجرة الزرقاء |
| 10335 | 10024 | BOUIRA البويرة | HAIZER | حيزر |
| 10336 | 10030 | BOUIRA البويرة | HANIF | حنيف |
| 10337 | 10006 | BOUIRA البويرة | KADIRIA | قادرية |
| 10338 | 10002 | BOUIRA البويرة | LAKHDARIA | الأخضرية |
| 10339 | 10003 | BOUIRA البويرة | M CHEDALLAH | أمشدالة |
| 10340 | 10039 | BOUIRA البويرة | MAALA | معلة |
| 10341 | 10071 | BOUIRA البويرة | MAAMORA | المعمورة |
| 10342 | 10040 | BOUIRA البويرة | MEZDOUR | مزدور |
| 10343 | 10075 | BOUIRA البويرة | OUED EL BERDI | وادي البردي |
| 10344 | BOUIRA البويرة | OULED RACHED | أولاد راشد | |
| 10345 | 10042 | BOUIRA البويرة | RAOURAOUA | روراوة |
| 10346 | 10083 | BOUIRA البويرة | RIDANE | ريدان |
| 10347 | 10043 | BOUIRA البويرة | SAHARIDJ | سحاريج |
| 10348 | 10044 | BOUIRA البويرة | SOUK EL KHEMIS | سوق الخميس |
| 10349 | 10004 | BOUIRA البويرة | SOUR EL GHOZLANE | سور الغزلان |
| 10350 | 10055 | BOUIRA البويرة | TAGHZOUT | تاغزوت |
| 10351 | 10045 | BOUIRA البويرة | TAGUEDITE | تاقديت |
EL-MOKRANI
المقراني
10332
10060
BOUIRA — البويرة
GUERROUMA
قرومة
10333
10037
BOUIRA — البويرة
HADJERA ZERGA
الحجرة الزرقاء
10334
10065
BOUIRA — البويرة
HAIZER
حيزر
10335
10024
BOUIRA — البويرة
HANIF
حنيف
10336
10030
BOUIRA — البويرة
KADIRIA
قادرية
10337
10006
BOUIRA — البويرة
LAKHDARIA
الأخضرية
10338
10002
BOUIRA — البويرة
M CHEDALLAH
أمشدالة
10339
10003
BOUIRA — البويرة
MAALA
معلة
10340
10039
BOUIRA — البويرة
MAAMORA
المعمورة
10341
10071
BOUIRA — البويرة
MEZDOUR
مزدور
10342
10040
BOUIRA — البويرة
OUED EL BERDI
وادي البردي
10343
10075
BOUIRA — البويرة
OULED RACHED
أولاد راشد
10344
BOUIRA — البويرة
RAOURAOUA
روراوة
10345
10042
BOUIRA — البويرة
RIDANE
ريدان
10346
10083
BOUIRA — البويرة
SAHARIDJ
سحاريج
10347
10043
BOUIRA — البويرة
SOUK EL KHEMIS
سوق الخميس
10348
10044
BOUIRA — البويرة
SOUR EL GHOZLANE
سور الغزلان
10349
10004
BOUIRA — البويرة
TAGHZOUT
تاغزوت
10350
10055
BOUIRA — البويرة
TAGUEDITE
تاقديت
10351
10045
BOUIRA — البويرة
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'