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) |
|---|---|---|---|---|
| 23849 | 23021 | ANNABA عنابة | OUED EL ANEB | واد العنب |
| 23850 | 23015 | ANNABA عنابة | SERAIDI | سرايدي |
| 23851 | 23028 | ANNABA عنابة | SIDI AMAR | سيدي عمار |
| 23852 | ANNABA عنابة | TREAT | التريعات | |
| 24853 | 24011 | GUELMA قالمة | AIN BEN BEIDA | عين بن بيضاء |
| 24854 | 24012 | GUELMA قالمة | AIN LARBI | عين العربي |
| 24855 | 24013 | GUELMA قالمة | AIN MAKHLOUF | عين مخلوف |
| 24856 | 24014 | GUELMA قالمة | AIN REGADA | عين رقادة |
| 24857 | 24032 | GUELMA قالمة | AIN SANDEL | عين صندل |
| 24858 | 24015 | GUELMA قالمة | BELKHEIR | بلخير |
| 24859 | 24034 | GUELMA قالمة | BENDJARAH | بن جراح |
| 24860 | GUELMA قالمة | BENI MEZLINE | بني مزلين | |
| 24861 | 24017 | GUELMA قالمة | BORDJ SABATH | برج صباط |
| 24862 | 24037 | GUELMA قالمة | BOU HACHANA | بوحشانة |
| 24863 | GUELMA قالمة | BOU HAMDANE | بوحمدان | |
| 24864 | 24018 | GUELMA قالمة | BOUATI MAHMOUD | بوعاتي محمود |
| 24865 | 24002 | GUELMA قالمة | BOUCHEGOUF | بوشقوف |
| 24866 | 24005 | GUELMA قالمة | BOUMAHRA AHMED | بومهرة أحمد |
| 24867 | 24031 | GUELMA قالمة | DAHOUARA | الدهوارة |
| 24868 | 24039 | GUELMA قالمة | DJEBALLAH KHEMISSI | جبالة الخميسي |
OUED EL ANEB
واد العنب
23849
23021
ANNABA — عنابة
SERAIDI
سرايدي
23850
23015
ANNABA — عنابة
SIDI AMAR
سيدي عمار
23851
23028
ANNABA — عنابة
TREAT
التريعات
23852
ANNABA — عنابة
AIN BEN BEIDA
عين بن بيضاء
24853
24011
GUELMA — قالمة
AIN LARBI
عين العربي
24854
24012
GUELMA — قالمة
AIN MAKHLOUF
عين مخلوف
24855
24013
GUELMA — قالمة
AIN REGADA
عين رقادة
24856
24014
GUELMA — قالمة
AIN SANDEL
عين صندل
24857
24032
GUELMA — قالمة
BELKHEIR
بلخير
24858
24015
GUELMA — قالمة
BENDJARAH
بن جراح
24859
24034
GUELMA — قالمة
BENI MEZLINE
بني مزلين
24860
GUELMA — قالمة
BORDJ SABATH
برج صباط
24861
24017
GUELMA — قالمة
BOU HACHANA
بوحشانة
24862
24037
GUELMA — قالمة
BOU HAMDANE
بوحمدان
24863
GUELMA — قالمة
BOUATI MAHMOUD
بوعاتي محمود
24864
24018
GUELMA — قالمة
BOUCHEGOUF
بوشقوف
24865
24002
GUELMA — قالمة
BOUMAHRA AHMED
بومهرة أحمد
24866
24005
GUELMA — قالمة
DAHOUARA
الدهوارة
24867
24031
GUELMA — قالمة
DJEBALLAH KHEMISSI
جبالة الخميسي
24868
24039
GUELMA — قالمة
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'