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) |
|---|---|---|---|---|
| 19709 | 19050 | SÉTIF سطيف | GUELLAL | قلال |
| 19710 | SÉTIF سطيف | GUELTA ZERKA | قلتة زرقاء | |
| 19711 | 19026 | SÉTIF سطيف | GUENZET | قنزات |
| 19712 | 19027 | SÉTIF سطيف | GUIDJEL | قجال |
| 19713 | 19059 | SÉTIF سطيف | HAMAM SOUKHNA | حمام السخنة |
| 19714 | 19015 | SÉTIF سطيف | HAMMA | الحامة |
| 19715 | 19051 | SÉTIF سطيف | HAMMAM GUERGOUR | حمام قرقور |
| 19716 | 19032 | SÉTIF سطيف | HARBIL | حربيل |
| 19717 | 19054 | SÉTIF سطيف | KASR EL ABTAL | قصر الابطال |
| 19718 | 19055 | SÉTIF سطيف | MAAOUIA | معاوية |
| 19719 | 19028 | SÉTIF سطيف | MAOUAKLANE | ماوكلان |
| 19720 | 19056 | SÉTIF سطيف | MEZLOUG | مزلوق |
| 19721 | 19115 | SÉTIF سطيف | OUED EL BARED | واد البارد |
| 19722 | 19053 | SÉTIF سطيف | OULED ADDOUANE | أولاد عدوان |
| 19723 | 19120 | SÉTIF سطيف | OULED SABOR | أولاد صابر |
| 19724 | 19121 | SÉTIF سطيف | OULED SI AHMED | أولاد سي أحمد |
| 19725 | 19030 | SÉTIF سطيف | OULED TEBBEN | أولاد تبان |
| 19726 | 19060 | SÉTIF سطيف | ROSFA | الرصفة |
| 19727 | 19013 | SÉTIF سطيف | SALAH BEY | صالح باي |
| 19728 | 19086 | SÉTIF سطيف | SERDJ-EL-GHOUL | سرج الغول |
GUELLAL
قلال
19709
19050
SÉTIF — سطيف
GUELTA ZERKA
قلتة زرقاء
19710
SÉTIF — سطيف
GUENZET
قنزات
19711
19026
SÉTIF — سطيف
GUIDJEL
قجال
19712
19027
SÉTIF — سطيف
HAMAM SOUKHNA
حمام السخنة
19713
19059
SÉTIF — سطيف
HAMMA
الحامة
19714
19015
SÉTIF — سطيف
HAMMAM GUERGOUR
حمام قرقور
19715
19051
SÉTIF — سطيف
HARBIL
حربيل
19716
19032
SÉTIF — سطيف
KASR EL ABTAL
قصر الابطال
19717
19054
SÉTIF — سطيف
MAAOUIA
معاوية
19718
19055
SÉTIF — سطيف
MAOUAKLANE
ماوكلان
19719
19028
SÉTIF — سطيف
MEZLOUG
مزلوق
19720
19056
SÉTIF — سطيف
OUED EL BARED
واد البارد
19721
19115
SÉTIF — سطيف
OULED ADDOUANE
أولاد عدوان
19722
19053
SÉTIF — سطيف
OULED SABOR
أولاد صابر
19723
19120
SÉTIF — سطيف
OULED SI AHMED
أولاد سي أحمد
19724
19121
SÉTIF — سطيف
OULED TEBBEN
أولاد تبان
19725
19030
SÉTIF — سطيف
ROSFA
الرصفة
19726
19060
SÉTIF — سطيف
SALAH BEY
صالح باي
19727
19013
SÉTIF — سطيف
SERDJ-EL-GHOUL
سرج الغول
19728
19086
SÉTIF — سطيف
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'