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) |
|---|---|---|---|---|
| 401321 | 40036 | KHENCHELA خنشلة | KHIRANE | خيران |
| 401322 | 40039 | KHENCHELA خنشلة | M'SARA | مصارة |
| 401323 | 40021 | KHENCHELA خنشلة | M'TOUSSA | متوسة |
| 401324 | 40013 | KHENCHELA خنشلة | OULED RECHACHE | أولاد رشاش |
| 401325 | 40041 | KHENCHELA خنشلة | REMILA | الرميلة |
| 401326 | 40024 | KHENCHELA خنشلة | TAMZA | طامزة |
| 401327 | 40011 | KHENCHELA خنشلة | TAOUZIANAT | تاوزيانت |
| 401328 | 40023 | KHENCHELA خنشلة | YABOUS | يابوس |
| 411329 | SOUK AHRAS سوق أهراس | AIN SOLTANE | عين سلطان | |
| 411330 | 41027 | SOUK AHRAS سوق أهراس | AIN ZANA | عين الزانة |
| 411331 | 41011 | SOUK AHRAS سوق أهراس | BIR BOUHOUCHE | بئر بوحوش |
| 411332 | 41015 | SOUK AHRAS سوق أهراس | DREA | الدريعة |
| 411333 | 41012 | SOUK AHRAS سوق أهراس | HADDADA | الحدادة |
| 411334 | 41016 | SOUK AHRAS سوق أهراس | HANENCHA | الحنانشة |
| 411335 | 41013 | SOUK AHRAS سوق أهراس | KHEDARA | الخضارة |
| 411336 | 41031 | SOUK AHRAS سوق أهراس | KHEMISSA | خميسة |
| 411337 | 41010 | SOUK AHRAS سوق أهراس | MACHROHA | المشروحة |
| 411338 | 41001 | SOUK AHRAS سوق أهراس | M'DAOUROUCHE | مداوروش |
| 411339 | 41004 | SOUK AHRAS سوق أهراس | MERAHNA | المراهنة |
| 411340 | 41018 | SOUK AHRAS سوق أهراس | OUED KEBRIT | وادي الكبريت |
KHIRANE
خيران
401321
40036
KHENCHELA — خنشلة
M'SARA
مصارة
401322
40039
KHENCHELA — خنشلة
M'TOUSSA
متوسة
401323
40021
KHENCHELA — خنشلة
OULED RECHACHE
أولاد رشاش
401324
40013
KHENCHELA — خنشلة
REMILA
الرميلة
401325
40041
KHENCHELA — خنشلة
TAMZA
طامزة
401326
40024
KHENCHELA — خنشلة
TAOUZIANAT
تاوزيانت
401327
40011
KHENCHELA — خنشلة
YABOUS
يابوس
401328
40023
KHENCHELA — خنشلة
AIN SOLTANE
عين سلطان
411329
SOUK AHRAS — سوق أهراس
AIN ZANA
عين الزانة
411330
41027
SOUK AHRAS — سوق أهراس
BIR BOUHOUCHE
بئر بوحوش
411331
41011
SOUK AHRAS — سوق أهراس
DREA
الدريعة
411332
41015
SOUK AHRAS — سوق أهراس
HADDADA
الحدادة
411333
41012
SOUK AHRAS — سوق أهراس
HANENCHA
الحنانشة
411334
41016
SOUK AHRAS — سوق أهراس
KHEDARA
الخضارة
411335
41013
SOUK AHRAS — سوق أهراس
KHEMISSA
خميسة
411336
41031
SOUK AHRAS — سوق أهراس
MACHROHA
المشروحة
411337
41010
SOUK AHRAS — سوق أهراس
M'DAOUROUCHE
مداوروش
411338
41001
SOUK AHRAS — سوق أهراس
MERAHNA
المراهنة
411339
41004
SOUK AHRAS — سوق أهراس
OUED KEBRIT
وادي الكبريت
411340
41018
SOUK AHRAS — سوق أهراس
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'