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) |
|---|---|---|---|---|
| 291071 | 29027 | MASCARA معسكر | MOCTA-DOUZ | مقطع الدوز |
| 291072 | 29003 | MASCARA معسكر | MOHAMMADIA | المحمدية |
| 291073 | 29058 | MASCARA معسكر | NESMOT | نسمط |
| 291074 | 29029 | MASCARA معسكر | OGGAZ | عقاز |
| 291075 | 29016 | MASCARA معسكر | OUED EL ABTAL | وادي الأبطال |
| 291076 | 29017 | MASCARA معسكر | OUED TARIA | وادي التاغية |
| 291077 | 29060 | MASCARA معسكر | RAS EL AIN AMIROUCHE | رأس عين عميروش |
| 291078 | 29062 | MASCARA معسكر | SEDJERARA | سجرارة |
| 291079 | 29063 | MASCARA معسكر | SEHAILIA | السهايلية |
| 291080 | 29065 | MASCARA معسكر | SIDI ABDELDJEBAR | سيدي عبد الجبار |
| 291081 | 29054 | MASCARA معسكر | SIDI ABDELMOUMENE | سيدي عبد المومن |
| 291082 | 29069 | MASCARA معسكر | SIDI BOUSSAID | سيدي بوسعيد |
| 291083 | 29030 | MASCARA معسكر | SIDI KADA | سيدي قادة |
| 291084 | 29001 | MASCARA معسكر | SIG | سيق |
| 291085 | 29004 | MASCARA معسكر | TIGHENNIF | تيغنيف |
| 291086 | MASCARA معسكر | TIZI | تيزي | |
| 291087 | 29019 | MASCARA معسكر | ZAHANA | زهانة |
| 291088 | 29057 | MASCARA معسكر | ZELAMTA | زلامطة |
| 301089 | OUARGLA ورقلة | AIN BEIDA | عين البيضاء | |
| 301093 | 30025 | OUARGLA ورقلة | EL BORMA | البرمة |
MOCTA-DOUZ
مقطع الدوز
291071
29027
MASCARA — معسكر
MOHAMMADIA
المحمدية
291072
29003
MASCARA — معسكر
NESMOT
نسمط
291073
29058
MASCARA — معسكر
OGGAZ
عقاز
291074
29029
MASCARA — معسكر
OUED EL ABTAL
وادي الأبطال
291075
29016
MASCARA — معسكر
OUED TARIA
وادي التاغية
291076
29017
MASCARA — معسكر
RAS EL AIN AMIROUCHE
رأس عين عميروش
291077
29060
MASCARA — معسكر
SEDJERARA
سجرارة
291078
29062
MASCARA — معسكر
SEHAILIA
السهايلية
291079
29063
MASCARA — معسكر
SIDI ABDELDJEBAR
سيدي عبد الجبار
291080
29065
MASCARA — معسكر
SIDI ABDELMOUMENE
سيدي عبد المومن
291081
29054
MASCARA — معسكر
SIDI BOUSSAID
سيدي بوسعيد
291082
29069
MASCARA — معسكر
SIDI KADA
سيدي قادة
291083
29030
MASCARA — معسكر
SIG
سيق
291084
29001
MASCARA — معسكر
TIGHENNIF
تيغنيف
291085
29004
MASCARA — معسكر
TIZI
تيزي
291086
MASCARA — معسكر
ZAHANA
زهانة
291087
29019
MASCARA — معسكر
ZELAMTA
زلامطة
291088
29057
MASCARA — معسكر
AIN BEIDA
عين البيضاء
301089
OUARGLA — ورقلة
EL BORMA
البرمة
301093
30025
OUARGLA — ورقلة
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'