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) |
|---|---|---|---|---|
| 27989 | 27021 | MOSTAGANEM مستغانم | SIRAT | سيرات |
| 27990 | 27046 | MOSTAGANEM مستغانم | SOUAFLIA | السوافلية |
| 27991 | 27022 | MOSTAGANEM مستغانم | SOUR | سور |
| 27992 | 27023 | MOSTAGANEM مستغانم | STIDIA | ستيدية |
| 27993 | 27047 | MOSTAGANEM مستغانم | TAZGAIT | تزقايت |
| 27994 | 27013 | MOSTAGANEM مستغانم | TOUAHRIA | الطواهرية |
| 281000 | 28026 | M'SILA المسيلة | BELAIBA | بلعايبة |
| 281002 | 28027 | M'SILA المسيلة | BENI ILMANE | بني يلمان |
| 281004 | 28010 | M'SILA المسيلة | BERHOUM | برهوم |
| 281007 | 28042 | M'SILA المسيلة | BOUTI SAYEH | بوطي السايح |
| 281008 | 28014 | M'SILA المسيلة | CHELLAL | شلال |
| 281009 | 28048 | M'SILA المسيلة | DEHAHNA | دهاهنة |
| 281013 | 28005 | M'SILA المسيلة | HAMMAM DALAA | حمام الضلعة |
| 281014 | 28056 | M'SILA المسيلة | KHETTOUTI SED-EL-JIR | خطوطي سد الجير |
| 281016 | 28011 | M'SILA المسيلة | MAADID | المعاضيد |
| 281017 | 28041 | M'SILA المسيلة | MAARIF | معاريف |
| 281018 | 28006 | M'SILA المسيلة | MAGRA | مقرة |
| 281019 | 28029 | M'SILA المسيلة | M'CIF | مسيف |
| 281023 | 00000 | M'SILA المسيلة | M'SILA | المسيلة |
| 281024 | M'SILA المسيلة | M'TARFA | المطارفة |
SIRAT
سيرات
27989
27021
MOSTAGANEM — مستغانم
SOUAFLIA
السوافلية
27990
27046
MOSTAGANEM — مستغانم
SOUR
سور
27991
27022
MOSTAGANEM — مستغانم
STIDIA
ستيدية
27992
27023
MOSTAGANEM — مستغانم
TAZGAIT
تزقايت
27993
27047
MOSTAGANEM — مستغانم
TOUAHRIA
الطواهرية
27994
27013
MOSTAGANEM — مستغانم
BELAIBA
بلعايبة
281000
28026
M'SILA — المسيلة
BENI ILMANE
بني يلمان
281002
28027
M'SILA — المسيلة
BERHOUM
برهوم
281004
28010
M'SILA — المسيلة
BOUTI SAYEH
بوطي السايح
281007
28042
M'SILA — المسيلة
CHELLAL
شلال
281008
28014
M'SILA — المسيلة
DEHAHNA
دهاهنة
281009
28048
M'SILA — المسيلة
HAMMAM DALAA
حمام الضلعة
281013
28005
M'SILA — المسيلة
KHETTOUTI SED-EL-JIR
خطوطي سد الجير
281014
28056
M'SILA — المسيلة
MAADID
المعاضيد
281016
28011
M'SILA — المسيلة
MAARIF
معاريف
281017
28041
M'SILA — المسيلة
MAGRA
مقرة
281018
28006
M'SILA — المسيلة
M'CIF
مسيف
281019
28029
M'SILA — المسيلة
M'SILA
المسيلة
281023
00000
M'SILA — المسيلة
M'TARFA
المطارفة
281024
M'SILA — المسيلة
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'